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Preface 


This manual describes the use of the Precision Architecture Rl SC 
(PA-RI SC) Assembler on H P 9000 computers. 

You need to be familiar with the machine instructions to use the 
Assembler. For a complete description of the machine instruction set, 
refer to PA-RI SC 1.1 Architecture and I nstruction Set Rderence Manual 
and PA-RI SC 2.0 Architecture 

Note that, throughout this manual, there are references to PA-RI SC 1.0, 
1.1, and 2.0. Each version of the architecture is a superset of the 
preceding version. 

Any program written for PA-RI SC 1.0 machines will execute on PA-RI SC 
1.1 and 2.0 machines, but programs using instructions uniqueto 
PA-RI SC 1.1 will not execute on PA-RI SC 1.0 machines. Any program 
written for PA-RI SC 1.1 machines will execute on PA-RI SC 2.0 
machines, but programs using features uniqueto PA-RI SC 2.0 will not 
execute on PA-RI SC 1.1 or 1.0 machines. 

Printing History 

New editions are complete revisions of the manual. Technical 
addendums or release notes may be released as supplements. 

The software version is the version level of the software product at the 
time the manual was issued. Many product updates and fixes do not 
require manual changes and, conversely, manual corrections may be 
done without accompanying product changes. Therefore, do not expect a 
one-to-one correspondence between product updates and manual 
updates. 


Edition 

Date 

Software 

Version 

First Edition 

November 1986 


U pdate 1 

March 1987 


U pdate 11 ncorporated 

May 1987 
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Edition 

Date 

Software 

Version 

Second Edition 

J anuary 1988 

92432-03A.00.03 

Third Edition 

November 1988 

92432-03A.00.04 

Fourth Edition 

J anuary 1991 

92432-03A.08.06 

Fifth Edition 

J anuary 1995 

92432-03A. 10.00 

Sixth Edition 

J une1996 

92432-03A. 10.20 

Seventh Edition 

May 1997 

92432-03A. 10.30 

Eighth Edition 

November 1997 

92453-03A.11.00 

Ninth Edition 

J une1998 

92453-03A.11.00 


You may send any suggestions for improvements in this manual to: 

Languages Information Engineering Manager 

Hewlett-Packard Company 

Mai I stop 42UD 

11000 Wolfe Road 

Cupertino CA 95014-9804 

Electronic Mail: editor@xip.hp.com 

Audience 

This manual assumes that you are an experienced assembly language 
programmer. In addition, you should have detailed understanding of the 
PA-RISC and hardwarefeatures, and a working knowledge of the HP-UX 
operating system, program structures, procedure calling conventions, 
and stack unwind procedures. 

Related Documentation 

For more information on HP-UX programming, refer to the foil owing 
documents: 

• PA-RISC 2.0 Architecture by Gerry Kane (Prentice-Hall, ISBN 
0-13-182734-0) 
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• HP-UX Linker and Libraries OnlineUser Guide, (id +heip) 

• 64-bit Runtime Architecture for PA-RISC 2.0. URL: 
http://www.software.hp.com/STK/ 

• ELF 64 Object FileFormat. URL: http://www.software.hp.com/STK/ 

Typographical Conventions 

Unless otherwise noted in the text, this manual uses the following 
symbolic conventions. 


computer font Computer font indicates commands, keywords, options, 
literals, source code, system output, and path names. 

I n syntax formats, computer font indicates commands, 
keywords, and punctuation that you must enter exactly 
as shown. 


bold face 
text 

italic type 


[ ] 

{ } 


name(N) 


I n examples, bold face text represents user input. 

I n syntax formats, words or characters in italics 
represent values that you must supply. Italics are also 
used for book titles and for emphasis. 

I n syntax formats, square brackets enclose optional 
items. 

I n syntax formats, braces enclose a list from which you 
must choose an item. 

In syntax formats, a horizontal ellipsis indicates that 
you can repeat the preceding item one or more times. 

An italicized word followed by a number in parentheses 
indicates an entry in HP-UX Rd'erence For example, 
cc(l) refers to the cc entry in Section 1 of HP-UX 
R Terence 


In This Manual 

The manual is organized as follows: 

Chapter 1 I ntroduces the Assembler for H P 9000 computers. 

Chapter 2 Explains assembly language program structure. 
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Chapter 3 Explains programming in Assembler for HP-UX. 

Chapter 4 Describes the PA-RI SC Assembler directives and 

pseudo-operations. 

Chapter 5 Summarizes the pseudo-instructions for the PA-RI SC 

machine instructions. 

Chapter 6 Describes the assembly (as) command and the ways to 

invoke the PA-RI SC Assembler under the H P-UX 
operati ng system. 

Chapter 7 Contains several sample assembly language programs. 

Chapter 8 Lists the diagnostic messages that the PA-RI SC 

Assembler can generate. 

Summary of Technical Changes for HP-UX 

11.0 

The foil owing features have changed for HP-UX 11.00 to support 

PA-RI SC 2.0W (wide), 64-bit mode. These changes are explained in detail 

in the appropriate locations in this manual. 

• I n 64-bit mode, the linkage pointer register is %r 27 . SeeTable 2-11, 
"Available Field Selectors,"on page31. 

• I n 64-bit mode, the Executable and Linking Format (ELF) uses 
segments and sections rather than spaces and subspaces. See 
"Sections in 64-bit Mode"on page 44. 

• The Assembler ignores the .call directive. This means that your 
program must ensure that the caller and called procedure agree on 
argument locations. See ".CALL Directive" on page 63. 

• The .CALLINFO directive parameters include updates to support 
64-bit mode. 

• You can specify 2.0W with the .LEVEL directive to tel I the the 
Assembler to generate 64-bit object code. For details, see ".LEVEL 
Directive"on page 93. 

• New and changed Assembler error messages. For details, seeChapter 
8, "Diagnostic Messages," on page 141. 
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Introduction to PA-RISC 
Assembly Language 


The HP 9000 Assembly Language represents machine language 
instructions symbolically, and permits declaration of addresses 
symbolically as well. The Assembler's function is to translate an 
assembly language program, stored in a source file, into machine 
language. The result of this translation resides in a relocatable object file. 
The object file is relocatable because it can still be combined with other 
relocatable object files and libraries. Therefore, it is necessary to relocate 
any addresses that the Assembler chooses for the symbols in the source 
program. 

This process of combining object files and libraries is performed by the 
linker, id. The linker's task is to transform one or more relocatable 
object files into an executable program file. Every program must be 
linked before it can be executed, even if the source file is complete within 
itself and does not need to be combined with other files. 


Assembler Features 

The Assembler provides a number of features to make assembly 

language programming convenient. These features include: 

• Mnemonic Instructions. Each machine instruction is represented 
by a mnemonic operation code, which is easier to remember than the 
binary machine language operation code. The operation code, 
together with operands, directs the Assembler to output a binary 
machine instruction to the object file. 

• Symbolic Addresses. You can select a symbol to refer to the address 
of a location in virtual memory. The address is often referred to asthe 
value of the symbol, which should not be confused with the value of 
the memory locations at that address. These symbols are called 
relocatable symbols because the actual addresses represented by such 
symbols are subject to relocation by the linker. 

• Symbolic Constants. A symbol can also be selected to stand for an 
integer constant. These symbols are cal led absolute symbols because 
the values of such symbols are not relocatable. 
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Introduction to PA-RISC Assembly Language 

Assembler Features 


• Expressions. Arithmetic expressions can be formed from symbolic 
addresses and constants, integer constants, and arithmetic operators. 
Expressions involving only symbolic and integer constants, or the 
difference between two relocatable symbols, defined in the current 
module, are called absolute expressions. They can be used wherever 
an integer constant can be used. Expressions involving the sum or 
difference of a symbolic address and an absolute expression are cal led 
relocatable expressions or address expressions. The constant part of 
an expression, the part that does not refer to relocatable expressions, 
can use parenthesized subexpressions to alter operator precedence. 

• Storage Allocation. I n addition to encoding machine language 
instructions symbolically, storage may be initialized to constant 
values or simply reserved. Symbolic addresses and labels can be 
associated with these memory locations. 

• Symbol Scope. When two or more object files are to be combined by 
the linker, certain symbolic addresses can be defined in one module 
and used in another. Such symbols must be exported from the defining 
module and imported into the using module. I n the defining module, 
thesymbol hasuniversal scope, while in the using module, the symbol 
is unsatisfied. Other symbols declared in the source program that are 
not exported have local scope. 

• Subspaces and Location Counters. You can organize code and 
data into separate subspaces, and into separate location counters 
within each subspace. The programmer can move among the 
subspaces and location counters, while the Assembler changes the 
code and data into the correct order. I n 64-bit mode, however, the 
Executable and Linking Format (ELF) uses segments and sections 
rather than spaces and subspaces. 

• Macro Processing. A macro is a user-defined word, which is 
replaced by a sequence of instructions. I ncluding a macro in a source 
program causes the sequence of i nstructions to be i nserted i nto the 
program wherever the macro appears. 
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Introduction to PA-RISC Assembly Language 

Summary of Changes for PA-RISC 2.0 


Summary of Changes for PA-RISC 2.0 

The foil owing features have changed in PA-RI SC 2.0 architecture. These 
changes areexplained in moredetail in the appropriate locations in this 
manual. 

• A new .DWORD directive reserves 64 bits (a doubleword) of storage 
and initializes it to the given value. 

• A .LEVEL 2.0 directive should be used as the first directive in the 
source file to assemble it for a PA-RISC 2.0 system. 

• New +DA2.0 option 

• N ew and changed Assembler error messages 


Summary of Changes for PA-RISC 2.0W 
(Wide Mode, 64-bit) 

The Assembler for PA-RI SC 2.0W, the 64-bit version of PA-RI SC 2.0, 
maintains the same source syntax as that of PAl.x and PA2.0 32-bit 
mode versions. However, PA2.0W features differ in the features listed 
below. 

• To assemble a source filefor a PA-RISC 64-bit system, use a .LEVEL 
2.0W directive as the first directive in the source file. See ".LEVEL 
Directive"on page 93. 

• The Assembler generates an Executable and Linking Format (ELF) 
object fileformat with PA-RI SC 2.0W. Refer to the ELF 64 Object File 
Format, URL: http://www.software.hp.com/STK/for details on ELF 
format. 

• PA-RI SC 2.0W supports a flat virtual address space of 2**64 bytes, 
and therefore does not support use of space registers. Use the 
following syntax when memory operations are used: 

ex: LDD disp(b), tgt 


Chapter 1 
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Introduction to PA-RISC Assembly Language 

Summary of Changes for PA-RISC 2.0W (Wide Mode, 64-bit) 


You can explicitly use space registers, however, the Assembler issues 
a warning if it is other than srO. 

• Some of the completers on addb and addib instructions are not valid 
for PA2.0W. I n addition, new completers are available. 

For example: znv, sv, and od are not valid whereas *=, *<, and *<= 
are additional completers. 

Please refer to the PA-RI SC 2.0 Architecture guide for details. 

• The displacement on both general load/store and floating load/store 
instructions can be up to 16 bits. For example, 

ex: FLDD disp(b),tgt ; displacement can be up to 16 bits. 

Please refer to PA-RI SC 2.0 Architecturefor details. 

• You must change any .word directives that are initialized with a code 
symbol or data symbol to . dword. 

• You can not use space identification operations such as mtsp and 
ldsid used for dealing with space registers in user level code. 
Currently, the Assembler does not give any warning. 

• The procedure calling conventions are different in the H P-UX 
PA-RISC 2.0 64-bit architecture. In PA 2.0W, you can pass the first 
eight parameters in registers (arg0-arg7). In earlier versions (PA1.0 
and PA1.1) and on PA-RISC 2.0, you can only pass the first four 
parameters in registers(arg0-arg3). For more information, please 
refer to the 64-bit Runtime Architecture for PA-RISC 2.0, at URL: 
http://www.software.hp.com/STK/. 
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2 


Program Structure 


An assembly language program is a sequence of statements. There are 
three classes of statements: 

• Instructions 

• Pseudo-operations 

• Directives 

I nstructions represent a single machine instruction in symbolic form. 
Pseudo-operations cause the Assembler to initialize or reserve one or 
more words of storage for data, rather than machine instructions. 
Directives communicate information about the program to the 
Assembler, but do not generally cause the Assembler to output any 
machine instructions. 

An assembly statement contains four fields: 

• Label 

• Opcode 

• Operands 

• Comments 

Each of these fields is optional. However the operands field cannot 
appear without an opcode field.The label field is used to associate a 
symbolic address with an instruction or data location, or to define a 
symbolic constant using the .equ, .reg, or .macro directives. This field 
is optional for all but a few statement types; if present, the label must 
begin in column one of a source program line. I fa label appears on a line 
by itself, or with a comment only, the label is associated with the next 
address within the same subspace and location counter. 

When the label field begins with the pound sign (#) character, it is not 
treated as a label. If # is followed by white space and an integer, the 
Assembler's line number counter, used when reporting errors, is reset to 
the value of the integer. Otherwise, the line beginning with # is ignored. 
This feature is for the use of the C language preprocessor cpp. 

The opcode field contains either a mnemonic machine instruction, a 
pseudo-operation code, or the name of an Assembler directive. It must be 
separated from the label field by a blank or tab. For certain machine 
instructions, the opcode field can also contain completers, separated from 
the instruction mnemonic by commas. 
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Program Structure 


The machine instruction mnemonics and completers are described in the 
PA-RISC 1.1 Architecture and I nstruction Set Rderence Manual and 
PA-RISC 2.0 Architecture. 

The operands field follows the opcode field, separated by a blank or tab. 
Operands are separated by commas. The meaning of the operands 
depends on the specific statement type, determined by the opcode. 

The number of operands permitted or requi red depends upon the specific 
instruction. 

The comments field is introduced with a semicolon, and causes the 
Assembler to ignore the remainder of the source line. A comment can 
appear on a line by itself. 

The following listing contains several assembly language statements. 
The headings identify the four fields. 


Label 

Opcode 

Operands 

JAN 

.EQU 

l 

SUM 

.WORD 

0 

LOOP 

LDW 

4(%rl),%r2 


ADD 

%r2,%r3,%r4 


STW 

%r4,SUM-$global$(%dp) 


BL 

LOOP,%r0 


Comments 

/declares a symbolic constant 
;reserve a word and set to zero 


Statements are normally written on separate lines. It is sometimes 
useful, especially when using a macro preprocessor, to be able to write 
several statements on one line. This can be done by separating the 
statements with the "! "character. When this feature is used, a label can 
be placed only on the first statement of the line, and a comment can only 
follow the last statement on the line. The . label directive can override 
this condition by providing a means for declaring a label within a 
multi-statement line. 
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Program Structure 

Symbols and Constants 


Symbols and Constants 

Both addresses and constants can be represented symbolically. Labels 
represent a symbolic address except when the label is on an . equ, . reg, 
or .macro directive. If the label ison an .equ or .reg directive, the 
label represents a symbolic constant. I f the I abel isthe .macro directive, 
the label represents a macro name. 

Symbols are composed of uppercase and Iowercase Ietters (a-z and a-z), 
decimal digits (0-9), dollar signs ($), periods (.), ampersands (&), pound 
signs (#), and underscores (_). A symbol can begin with a letter, digit, 
underscore, or dollar sign. If a symbol begins with a digit it must contain 
a non-digit character. (The predefined register symbols begin with a 
percent sign (%).) 

The Assembler considers uppercase and lowercase letters in symbols to 
be distinct. The mnemonics for operation codes, directives, and 
pseudo-operations can be written in either case. There is no explicit limit 
on the length of a symbol. The following areexamples of legal symbols: 

$START$ _start PROGRAM M$3 $global$ 

$$mull main P_WRITE loopl lst_time 

The following areexamples of illegal symbols: 
loop 11 Contains an illegal character 

&st_time Beginswith& 

123 Does not contain a nondigit 

Integer constants can be written in decimal, octal, or hexadecimal 
notation, as in theC language. "Integer Constants" on page 22 lists the 
ranges of these integer constants. 


Chapter 2 
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Table 2-1 


Program Structure 

Symbols and Constants 


Integer Constants 



Signed 

Unsigned 

Deci mal 

-2147483648 

through 

2147483647 

0 

through 

4294967295 

Octal 

020000000000 

through 

017777777777 

0 

through 

037777777777 

Hexadecimal 

0x80000000 

through 

0x7FFFFFFF 

0 

through 

OxFFFFFFFF 


The period (.) is a special symbol reserved to denote the current offset of 
the location counter. It is useful in address expressions to refer to a 
location relative to the current instruction or data word. This symbol is 
considered relocatable, and can be used anywhere a relocatable symbol 
can be used, with the exception of the label field. 

The period cannot be used in an expression involving another label, such 
as sym+., sym-., . +sym, or . -sym. 11 can be used in an expression that 
has only a constant, such as . +8 or . - 8 . 
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Program Structure 

Registers and Register Mnemonics 


Registers and Register Mnemonics 

PA-RI SC processors have four sets of registers: 

• General 

• Floating-point 

• Space 

• Control 

Data is loaded from memory into general or floating-point registers and 
stored into memory from general or floating-point registers. Arithmetic 
and logical operations are performed on the contents of the general 
registers. On PA-RI SC 1.0 or 1.1 each general register is 32 bits wide. On 
PA-RI SC 2.0 each general register is 64 bits wide. On PA-RI SC 2.0W 
(true 64-bit environment) each general register is 64 bits wide. 

There are 32 general registers, denoted as %r0 through %r3i. General 
register %r0 is special because "writes" into it are ignored, and it always 
reads as zero. The remaining general registers can be used normally, 
with the caution that %ri is the implicit target register for the addil 
instruction, %r3i is the implicit link register for theBLE instruction, and 
for PA-RI SC 2.0 only, %r2 is the implicit link register for the BLVE 
instruction. Certain general registers also have predefined conventional 
uses. Refer to "Register Procedure Calling Conventions" on page 28. You 
can find detailed information on both 32-bit and 64-bit runtime 
architecture under the topic PA-RI SC Architecture at 
http://www.software.hp.com/STK/. 

PA-RI SC 1.0 machines have 16floating-point registers; PA-RI SC 1.1, 2.0, 
and 2.0W (true 64-bit envi ronment) machi nes have 32 floati ng-poi nt 
registers. Each register is capable of holding either a single- or 
double-precision floating-point number in IEEE format. These registers 
are denoted %frO through %fri5 for PA-RI SC 1.0 and %frO through 
%fr3l for PA-RI SC 1.1, 2.0, and 2.0W. 

Registers %f ri, %f r2, and %f r3 are exception registers and are not 
avail able to the programmer. Floating-point register %frO contains a 
permanent floating-point zero when used in an arithmetic operation; 
when written or read with floating-point loads or stores, the 
floating-point status register is actually accessed. 


Chapter 2 
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NOTE 


Program Structure 

Registers and Register Mnemonics 


I n addition, on PA-RI SC 1.1, 2.0. and 2.0W the left and right halves of 
the floating-point registers can be accessed as separate single-precision 
registers by using an l or r suffix. 

For example, %fr8R accesses the right-most 32 bits of %fr8 as a 
single-precision number. 

The l or r suffixes can only be used on the predefined floating-point 
registers in the form %frnn, where nn is the register number. It is not 
legal to use l or r with an integer value. For example, %fr8R is legal; 8R 
is not legal. 

The space registers form the basis of the virtual memory system. Each of 
the eight space registers can hold a 16- or 32-bit space identifier, 
dependi ng on the hardware model. The space registers are denoted as 
%srO through %sr7. Space register %srO isset implicitly bytheBLE 
instruction, and space registers %sr5 through %sr7 cannot be modified 
except by code running at the most privileged level. 

The control registers contain system-state information. Thereare25 
control registers, denoted as %crO and %cr8 through %cr3l. Of these 
registers, only %crii (%sar), the shift amount register, and %cri6 
(%itmt), the interval timer, are normally accessibleto the user-level 
programmer. The other registers are accessed only by code running at 
the most privileged level. 

Register operands are denoted by register-typed constants because the 
Assembler needs to be ableto differentiate between general registers, 
space registers, floating point registers, and ordinary integer constants. 

To make assembly code more readable, you can use the .reg directive to 
declare a symbolic name as an alias for a predefined register. The 
predefined registers have a register type associated with them. The 
Assembler enforces register type checking and issues a warning message 
if the wrong kind of register is used within an operand. A warning is also 
issued when an integer constant or absolute expression is found where a 
register is expected. You must use the .reg directive to define symbolic 
register names. If a symbolic name defined in an .equ directive is used 
where a register symbol is expected, the Assembler issues a warning 
message, because it considers an . equ defined symbol to be a simple 
integer constant. 

If an absolute expression is used instead of a register or register-typed 
symbol name, the Assembler issues warning message number 41. 
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This warning can be suppressed with the-w4i command-line option. 
Future versions of the Assembler may not always allow an absolute 
expression where a register is expected. 

The following example demonstrates the correct usage of the .reg 
directive: 

tblptr .REG %r20 

aka_tbl .REG tblptr 

Predefined registers are shown in the following tables. All of the 
mnemonics begin with the % character, so they do not conflict with any 
programmer-defined symbols. 

General Registers 


%r0 

%r8 

%rl 6 

%r24 

%rl 

%r 9 

%rl7 

%r25 

%r2 

%rlO 

%rl 8 

%r2 6 

%r3 

%r 11 

%rl 9 

%r27 

%r4 

%r 12 

%r2 0 

%r28 

%r5 

%rl3 

%r21 

%r2 9 

%r 6 

%rl4 

%r22 

%r30 

%r7 

%r!5 

%r23 

%r31 
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Single-Precision Floating-Point Registers 


%f rOL 

%f r8L 

%frl6L 

%fr2 4L 

%f rlL 

%f r 9L 

%frl7L 

%fr25L 

%f r2L 

%frlOL 

%frl8L 

%fr2 6L 

%f r3L 

%frllL 

%frl9L 

%fr27L 

%f r4L 

%frl2L 

%fr2 OL 

%fr2 8L 

%f r5L 

%frl3L 

%fr21L 

%fr2 9L 

%f r 6L 

%frl4L 

%fr22L 

%fr30L 

%f r7L 

%frl5L 

%fr23L 

%fr31L 

%f rOR 

%f r8R 

%frl6R 

%fr2 4R 

%f rlR 

%f r 9R 

%frl7R 

%fr25R 

%f r2R 

%frlOR 

%frl8R 

%fr2 6R 

%f r3R 

%f rllR 

%frl9R 

%fr27R 

%f r4R 

%frl2R 

%fr2 OR 

%fr2 8R 

%f r5R 

%frl3R 

%fr21R 

%fr2 9R 

%f r 6R 

%frl4R 

%fr22R 

%fr30R 

%f r7R 

%fr!5R 

%fr23R 

%f r31R 

Accessing the right half off 
separately is possible only c 
architectures. 

Registers %fri6L through ^ 
through %fr3iR are availak 
later architectures. 

loating-point registers 
in PA-RI SC 1.1 or later 

r31L and %f rl 6R 

ole only on PA-RI SC 1.1 or 
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Double-Precision Floating-Point Registers 


%f rO 

%f r8 

%f rl 6 

%f r24 

%f rl 

%f r 9 

%frl7 

%f r25 

%f r2 

%f rlO 

%f rl 8 

%f r2 6 

%f r3 

%f r 11 

%f rl 9 

%fr27 

%f r4 

%f r 12 

%f r2 0 

%f r28 

%f r5 

%frl3 

%f r21 

%f r2 9 

%f r6 

%frl4 

%f r22 

%f r30 

%fr7 

%frl5 

%f r23 

%fr31 

Registers %fri6 througl 
only on PA-RI SC 1.1 or 1 

h %f r31 are available 
ater architectures. 


Space Registers 


%srO 

%sr2 

%sr4 

%sr 6 

%srl 

%sr3 

%sr5 

%sr7 


Control Registers 


Registers 

Synonyms 

Registers 

Synonyms 

%crO 

%rctr 

%cr2 0 

%isr 

%cr8 

%pidrl 

%cr21 

%ior 

%cr 9 

%pidr2 

%cr22 

%ipsw 

%crlO 

%ccr 

%cr23 

%eirr 

%crl 1 

%sar 

%cr2 4 

%trO %ppda 

%crl2 

%pidr3 

%cr25 

%trl %hta 

%crl3 

%pidr4 

%cr2 6 

%tr2 

%crl4 

%iva 

%cr27 

%tr3 

%crl5 

%eiem 

%cr2 8 

%tr4 

%crl 6 

%itmr 

%cr2 9 

%tr5 

%crl7 

%pcsq 

%cr30 

%tr 6 

%crl 8 

%pcoq 

%cr31 

%tr7 

%crl 9 

%iir 




Chapter 2 


27 






Program Structure 

Registers and Register Mnemonics 


Table 2-7 


Some additional predefined register mnemonics are provided in 
"Register Procedure Calling Conventions" on page 28 to match the 
standard procedure-calling convention. This is discussed briefly in 
"HP-UX Architecture Conventions" on page 39. You can find detailed 
information on both 32-bit and 64-bit calling conventions under the topic 
PA-RISC Architecture at URL: http://www.software.hp.com/STK/. 

Register Procedure Calling Conventions 


Register 

Synonyms 

Description 

%f r4 

%fargO %fret 

Floating argument, return value 

%f r5 

%fargl 

Second floating argument 

%f r 6 

%farg2 

Third floating argument 

%fr7 

%farg3 

Fourth floating argument 

%r2 

%rp 

Return link 

%rl 9 

%t4 

Fourth temporary register 

%r20 

%t3 

Third temporary register 

%r21 

%t2 

Second temporary register 

%r22 

%tl 

First temporary register 

%r23 

%arg3 

Argument word 3 

%r24 

%arg2 

Argument word 2 

%r25 

%argl 

Argument word 1 

%r2 6 

%argO 

Argument word 0 

%r27 

%dp 

Data pointer 

%r28 

%retO 

Return value 

%r2 9 

%retl %sl 

Return value, static link 

%r30 

%sp 

Stack poi nter 

%r31 

%mrp 

Mi 11 icode return link 

%srl 

%sret %sarg 

Return value, argument 


I n addition, there is a special register mnemonic defined as 
%previous_sp, that al lows access to the previous value of the stack 
poi nter. 

%previous_sp must be used in the position of a base register; it can be 
used only between .enter and .leave pseudo-operations. 
%previous_sp is the same as %sp unless the current . proc has a large 
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frame (that is, .callinfo specified frame > 8191) or .callinfo 
specified . alloca_frame. In those two cases, %previous_sp is the 
same as %r3, and %r3 is set up by the . enter pseudo-operation. 


Expressions 

Arithmetic expressions are often valuable in writing assembly code. The 
Assembler allows expressions involving integer constants, symbolic 
constants, and symbolic addresses. These terms can be combined with 
the standard arithmetic operators shown in "Standard Arithmetic 
Operators" on page 29 or with bit-wise operators shown in "Bit-Wise 
Operators" on page 29. 


Standard Arithmetic Operators 


Operator 

Operation 

+ 

1 nteger addition 

- 

1 nteger subtraction 

•k 

Integer multiplication 

/ 

Integer division (result is truncated) 


The multiplication and division operators have precedence over addition 
and subtraction. That is, multiplications and divisions are performed 
first from left to right, then additions and subtractions are performed 
from left to right. Therefore, the expression 2+3*4 evaluates to 14. 

Bit-Wise Operators 


Operator 

Operation 

1 

Logical OR 

& 

Logical AND 

~ 

Unary logical complement (tilde) 
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Expressions produce either an absolute or a relocatable result. Any 
operation involving only absolute terms yields an absolute result. 
Relocatable terms are allowed only for the + and - operators. The legal 
combinations involving relocatable terms are shown in "Legal 
Combinations For Relocatable Terms" on page 30. 

Table 2-10 Legal Combinations For Relocatable Terms 


Operation 

Result 

Absolute! Relocatable 

Relocatable 

Relocatable + Absolute 

Relocatable 

Relocatable - Absolute 

Relocatable 

Relocatable - Relocatable (defined locally) 

Absol ute 


For more information on the term relocatable; refer to "Assembler 
Features" on page 15. 


NOTE The combi nation "relocatable-relocatable+relocatable" is not permitted. 


For example, assume the symbols month and year are relocatable, and 
January and February are absolute. The expressions month+January 
and month+february-4 are relocatable, while the expressions 
year-month and february-4 are absolute. The expression 
month+January*4 is also legal and produces a relocatable result, 
because January*4 is evaluated first, producing an absolute 
intermediate result that is added toMONTH. The expression month+year 
is illegal, becausethesum of two relocatable terms is not permitted. 

Because all instructions area singleword in length, it is not possibleto 
form a complete 32-bit address in a single instruction. Therefore, it is 
likely that the Assembler (or linker) may not be able to insert the final 
address of a symbol into the instruction as desired. For example, to load 
the contents of a word into a register, the following instruction could be 
used: 

LDW START,%r2 

Because ldw provides only 14 bits for the address of start, the 
Assembler or linker prints an error message if the address of start 
requires more than 14 bits. There are two instructions, ldil and addil, 
whose function is to form the left-most 21 bits of a 32-bit address. The 
succeeding instruction, by using the target of the ldil or addil as a 
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base register, needs only 11 bits for the remainder of the address. The 
Assembler provides special operators, called field selectors, that extract 
the appropriate bits from the result of an expression. With the field 
selectorsL' and R' , the previous example can be recoded as follows: 

LDIL L'START,%rl ;put left part into rl 

LDW R'START(%rl),%r2 ;add rl and right part 

The field selectors arealways applied tothe final result of the 
expression. They cannot be used in the interior of an expression. 
"Available Field Selectors" on page 31 shows all the available field 
selectors and their meanings. 

Available Field Selectors 


Field 

Selector 

Meaning 

f ' or F% 

Full 32 bits (default). 

L ' or L% 

Right-justified, high-order 21 bits. 

r ' or R% 

Low-order 11 bits. 

ls' or 

LS% 

High-order 21 bits after rounding to nearest multi pleof 
2048. 

rs ' or 

RS% 

Low-order 11 bits, sign extended. 

LD' or 

LD% 

Right-justified, high-order 21 bits after rounding to next 
multiple of 2048. 

rd' or 

RD% 

Low-order 11 bits, with negative sign. 

LR' or 

LR% 

l% value with constant rounded to nearest multiple of 

8192. 

RR' or 

RR% 

r% value with constant rounded to nearest multiple of 

8192, plus the difference of the constant and the rounded 
constant. 

T ' or T% 

f% value offset of data linkage table slots from linkage 
table pointer. In 32-bit mode, the linkage table pointer is 
%r 19. 1 n 64-bit mode, the linkage table pointer is %r27. 
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Field 

Selector 

Meaning 

lt' or 

LT% 

lr% value offset of data linkage table slots from linkage 
table pointer. In 32-bit mode, the linkage table pointer is 
%r 19. 1 n 64-bit mode, the linkage table pointer is %r27. 

RT ' or 

RT% 

rr% value offset of data linkage table slots from linkage 
table pointer. In 32-bit mode, the linkage table pointer is 
%r 19. 1 n 64-bit mode, the linkage table pointer is %r27. 

Q ' or Q% 

f% value offset of procedure linkage table slots from 
linkage table pointer. In 32-bit mode, the linkage table 
pointer is %ri9. In 64-bit mode, the linkage table pointer 

is %r27. 

LRQ ' or 

LRQ% 

lr% value offset of procedure linkage table slots from 
linkage table pointer. 1 n 32-bit mode, the linkage table 
pointer is %ri9. 1 n 64-bit mode, the linkage table pointer 

is %r27. 

rrq ' or 

RRQ% 

rr% value offset of procedure linkage table slots from 
linkage table pointer. In 32-bit mode, the linkage table 
pointer is %ri9. 1 n 64-bit mode, the linkage table pointer 

is %r27. 

p ' or P% 

Data procedure label (plabel) constructor. 

lp ' or 

LP% 

Code procedure label (plabel) constructor used in ldil 
instruction. 

rp ' or 

RP% 

Code procedure label (plabel) constructor used in ldo 
instruction. 

N ' or N% 

A null field selector, which isappliedtoan ldo instruction 
to allow a three-instruction sequence. 

NL' or 

NL% 

Right-justified, high-order 21 bits; allows a 
three-instruction sequence. 
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Field 

Selector 

Meaning 

NLD ' or 

NLD% 

Right-justified, high-order 21 bits after rounding to next 
multiple of 2048; allows a three-instruction sequence. 

nlr ' or 

NLR% 

l% value with constant rounded to nearest multiple of 

8192; allows a three-instruction sequence. 

nls ' or 

NLS% 

High-order 21 bits after rounding to nearest multi pleof 
2048; allows a three-instruction sequence. 


On PA-RI SC 1.0, the page size is 2048 bytes long; on PA-RI SC 1.1, 2.0, 
and 2.0W the page size is 4096. The selectors l ', ls ', and ld ' modulate 
by 2048, and the corresponding selectors R', rs ', and rd ' extract the 
offset relative to that address. 

The distinction is whether the offset is always positive and between o 
and 0x7ff (L'-R'), always negative and between -0x800 and -l 
(ld ' -rd '), or between -0x400 and 0x3ff (ls ' -rs '). This 
distinction is only important when using short addressing near a 
quadrant boundary, because only the left part is used to select a space 
register. Each pair is designed to work together just as l ' andR' do in 
the previous example. See "Spaces" on page 39. The lr' and rr' 
prefixes are used for accessi ng different fields of a structure, al I owi ng the 
sharing of the lr' computation. 

For shared libraries, the field selectors t ', lt ', rt ', q ', lrq ', and rrq ' 
are used in conjunction with the position-independent code options +z or 

+z. 

The field selectors p ', lp ', and rp ' are used to form piabeis 
(procedure labels) for use in dynamic calls. With position-independent 
code, the use of piabel values, rather than simple code addresses, is 
required. Refer to the H P-UX Linker and Libraries Online User Guide 
and ELF 64 Object FileFormat, http://www.software.hp.com/STK/for 
more information. 

For example, toget a procedure label for foo, use the foil owing code: 

ADDIL LTP'foo,%r27,%rl ;get left portion of plabel pointer. 

LDO RTP'foo(%rl),%r4 ;add right portion to form a complete 

; plabel pointer. 


The field selectors in the above example can also be written lp% and rp%. 
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Parenthesized Subexpressions 

The constant term of an expression may contain parenthesized 
subexpressions that alter the order of evaluation from the precedence 
normally associated with arithmetic operators. For example: 

LABEL1-LABEL2+((67 65+(2048-1))/2048) *2048 

contains a parenthesized subexpression that rounds a value up to a 
multiple of 2048. 

Absolute symbols may be equated to constant terms containing 
parenthesized subexpressions as in the following sequence: 

BASE .EQU 0x200 

N_EL .EQU 2 4 

SIZE .EQU (BASE+4)*N_EL 

NOTE The use of parentheses to group subexpressions may cause ambiguities 

in statements where parenthesized register designators are also 
expected. 
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Operands and Completers 

Machine instructions usually require one or more operands. 

These operands tel I the processor what data to use and where to store 
the result. Operands can identify a register, a location in memory, or an 
immediate constant (that is, data that is coded into the instruction 
itself). The operation code determines how many and what kinds of 
operands are required. 

Registers used in operands should be either predefined register symbols 
(with the % prefix) or user-defined register symbols defined with the . reg 
directive. They can also be absolute expressions. See "Registers and 
Register M nemonics" on page 23 in this chapter. 

The following example shows a few machine instructions with register 
operands: 


■ REG 

%r 18 

;define register 

SCRATCH 

ADD 

%r3,%r7,%r4 

;r3 + r7 -> r4 


OR 

%r7,%r3,%r8 

;inclusive or of 

r7,r3 -> r8 

COPY 

SCRATCH,%r7 

;copy rl8 to r7 


MTCTL 

%r2,%sar 

; set shift amount 

register (crll) 

MFSP 

%sr4,%r!0 

;fetch contents of sr4 


Operands designating memory locations usually consist of an expression 
and a general register used as a base register. Some instructions also 
require a space register designation. I n general, such operands are 
written in the form expr (sr, gr) or expr (gr), as in the foil owing 
examples: 


local_off 

.EQU 

-64 


LDW 

4(%dp),%r2 


STW 

%r0,local_off-4(%sp) 


LDW 

0(%sr3,%r2),%r9 


Notice that the space register can be omitted on instructions that allow 
short addressing, as in the stw instruction shown above. 

If only one register is given, it is assumed to be the general register, and 
the space register field in the machine instruction is set to zero, which 
indicates short addressing. 

The expression in a memory operand is either absolute or relocatable. 
Absolute expressions are meaningful when the base register contains the 
address of an array, record, or the stack poi nter to which a constant offset 
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is required. Relocatable expressions are meaningful when the base 
register is %r0, or when the base register contains the left part of a 32-bit 
address as illustrated in the foil owing example: 

LDIL L%glob,%rl ;set up %rl for STW 

STW %r9,R%glob(%r1) 

I mmediate operands provide data for the machine language instruction 
directly from the bits of the instruction word itself. A few instructions 
that use immediate operands are shown below: 


ADDIL 

L%var,%dp 

LDIL 

L%print,%rl 

ADD I 

4,%r3,%r5 

SUBI 

OxlCO,%r!4. 


Completers are special flags that modify an instruction's behavior. They 
are written in the opcode field, separated from the instruction mnemonic 
by a comma. The most common type of completer is a condition test. 
Many instructions can conditionally trap or nullify the following 
instruction, depending on the result of their normal operation. For 
example, notice the completers in the sequence below: 

ADD,NSV %r1,%r2,%r3 

BL,N handle_oflo,%r0 

OR %r3,%r4,%r5 

The , nsv in the add instruction nullifies the bl instruction if no 
overflow occurs in the addition operation, and execution proceeds with 
the or instruction. If overflow does occur, theBL instruction isexecuted, 
but the , n completer on the bl specifies that the or instruction in its 
delay slot should not be executed. 

Each class of machine instructions defines the set of completers that can 
be used. 

These are described in the PA-RI SC 1.1 Architecture and I nstruction Set 
Reference Manual and in PA-RI SC 2.0 Architecture. 
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Macro Processing 

A macro is a user-defined word that is replaced by a sequence of 
instructions. Including a macro in a source program causes the sequence 
of instructions to be inserted into the program wherever the macro 
appears. 

A user may define a word as a macro by using the .macro directive. 

Detailed information about macro arguments, placement and 
redefinition of macros, nested macro definitions, and nested macro calls 
is in "Assembler Directives and Pseudo-Operations" on page 53. 

Defining New Instructions With Macros 

If you aretesting new CPUs or coprocessors, you may need to use 
opcodes that are unknown to the Assembler. A variant of a macro 
definition may be used to create a mnemonic for the instruction. After 
being defined, the new mnemonic instruction can be invoked as easily as 
a standard instruction. 

Opcodes, subopcodes, completers, and operands are encoded into the 
instruction word in a bit-intensive manner because all PA-RISC 
instructions are one word, or 32-bits, in length. 

To write a macro, you must specify explicitly which bit fields are to 
contain constants and which are to contain macro arguments. The macro 
processor has no built-in knowledge of instruction formats. Defining new 
instructions through macros is only possible because a convenient way to 
delimit bit fields has been provided. It is uptothe programmer tochoose 
the correct bit field. 

Bit positions within the 32-bit word are numbered from zero to 31, from 
left to right. A bit range is indicated by the starting bit position followed 
by the ending bit position. The two bit positions are separated by two 
periods and enclosed in braces. The bit field beginning at bit position 6 
and ending at bit position 10 is represented as: 

{ 6 .. 10 } 

If the bit field being assigned from is bigger than the bit field being 
assigned to, then a warning is issued and the assigned-from bit field is 
truncated on the left. When no bit field is specified for the assigned-from 
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value, low-order bits are used until the value of the assigned-from bit 
field becomes the same as the width of the assigned-to bit field. The 
assigned-to bit field must always be specified. 

No sign extension is provided by the macro assembler when bit fields are 
generated. 

The following macro definition defines the macro pack with four formal 
parameters. 

PACK .MACRO BASE,GREG,SREG,OFFSET 

{0..5}=0x3E{26..31} 

{6..10}=BASE{27..31} 

{11..15}=GREG{27..31} 

{16..17}=SREG{30..31} 

{18..31}=OFFSET{18..31} 

. ENDM 

The following explanation assumes that pack is invoked with the 
statement: 

PACK %sp,%rl9,%sr0,-52 


Bit Field 

Description 

{0..5} 

Contai ns the six low-order bits of the new opcode 0x3E, 
or binary 111110, entered as a constant in the macro 
definition. 

{6..10} 

Contains general register 30, or binary 11110. These 
are the five low-order bits of the argument base inthe 
macro definition. 

{11..15} 

Contains general register 19, or binary 10011. These 
are the five low-order bits of the argument greg in the 
macro definition. 

{16. .17} 

Contains space register 0 and represents the five 
low-order bits of the argument sreg in the macro 
definition. 

{18. .31} 

Contains binary 11111111001100, the offset value 
-52, which was entered as an argument to the macro 
definition. 
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The Assembler is a flexible tool for writing programs, but every operati ng 
system imposes certain conventions and restrictions on the programs 
that are intended to run on that system. This chapter discusses the 
conventions that must be understood in order to write assembly 
language programs and procedures for the PA-RI SC instruction set on 
the H P 9000 Series 700 and 800 H P-UX operating system. Several 
Assembler directives are mentioned in this chapter to place them in a 
meaningful context. A full discussion of these directives is in Chapter 4, 
"Assembler Directives and Pseudo-Operations,"on page 53. 


Spaces 

Virtual addressing on PA-RI SC is based on spaces. A virtual address is 
composed of a space identifier, which is either 16 or 32 bits long 
(depending on the hardware model), and a 32-bit offset within the space. 
Therefore, each space can contain up to 4 gigabytes, and there is a large 
supply of spaces. 

I n the 64-bit mode architecture each application is provided a flat virtual 
address space of 2** 64 bytes, which is divided into four quadrants. Each 
quadrant is mapped into this global virtual address space by means of 
four space registers, which are under the control of the operating 
system. 

Every program on an HP-UX system is assigned two spaces when it is 
I oaded for executi on by the operati ng system: one for code, and one for 
data. The H P-UX operating system makes the code space read only, so 
that it can be shared whenever several processes are executi ng the same 
program. The data space is writable by the new process, and is private to 
that process; that is, every process has a unique data space.The actual 
space identifiers assigned to these two spaces can vary from one 
execution of the program to the next; these numbers cannot be 
determined at compile time or link time. Generally, programmers do not 
need to be concerned with the space identifiers, si nee the operating 
system places them in two reserved space registers, where they remain 
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for the duration of program execution. The identifier of the code space is 
placed in space register 4 (%sr4) and the identifier of the data space is 
placed in space register 5 (%sr5). 

When writing an assembly language program, declare a space named 
$text$ for executable code, and a space named $private$ for 
modifiable data. Constant data or literals that you do not plan to modify 
during program execution, can be placed in either space. Placing 
constant data inthe$TEXT$ space decreases the size of the nonsharable 
part of your program and improves the overall efficiency of the operating 
system. 

The particular space registers mentioned above play an important role in 
virtual addressing. While many of the branching instructions, such as 
bl, blr, and bv, are capable of branching only within the currently 
executi ng code space (cal led PC-space), two of the branchi ng i nstructions, 
be and ble, require that you specify a space register as well as an offset. 
These instructions allow you to branch to code executi ng in a different 
space. On HP-UX systems, normally all code for a program is contained 
in one space, so all be and ble instructions should be coded to use %sr4. 

I n contrast, the memory reference instructions, such as ldw and stw, 
allow a choice between two forms of addressing: long and short. With 
long addressing, you can choose any of the space registers 1 through 3 for 
the space identifier part of the virtual address. The space offset is formed 
as the sum of an immediate displacement and the contents of a general 
register. With short addressi ng, one of the space registers between 4 
through 7 is chosen automatically, based on the high-order two bits of the 
base register. Each space addressed by these four space registers is 
effectively divided into four quadrants, with a different quadrant of each 
space accessi bl e vi a short addressi ng. 

On H P-UX systems, all of a program's code is placed in quadrant zero of 
the $text$ space, or %sr4, (space offsets from o through 0x3fffffff). 
The data is placed in quadrant one of the $private$ space, or %sr5 
(space offsets from 0x40000000 through 0x7fffffff). Therefore, 
literal data in the code space and modifiable data in the data space can 
be addressed using the short addressing technique, without any concern 
for the space registers. 

The identifier for shared memory segments, including shared library 
text, is placed into space register 6 (%sr6). Shared memory and shared 
library text are placed into quadrant two of the shared memory space 
(offsets 0x80000000 through Oxbfffffff). The identifier for system 
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code is placed into space register 7 (%sr7). System code is placed into 
quadrant three of the system space (offsets OxCOOOOOOO through 
OxFFFFFFFF). Table 3-1 on page 41 shows the memory layout on H P-UX. 


Memory Layout on HP-UX 



%sr4 

%sr5 

%sr6 

%sr7 

0x00000000 

Program 

code 




0x40000000 


Program 
data stack 
Shared 
library data 



0x80000000 



Shared 
memory 
Shared 
library text 


OxCOOOOOOO 




System code 


You can define spaces other than $text$ and $private$ in a program 
file by declaring a special kind of space called an unloadablespace 
Unloadable spaces are treated as normal spaces by the linker, but as the 
name implies, are not actually loaded when a program is executed. 
Unloadable spaces are typically used by compilers to store extra 
information within a program file. The most common example of an 
unloadablespace is $debug$, which is used to hold symbolic debugging 
information. 

The sort key attribute allows the programmer to control the placement of 
a space relative to the other spaces. The linker places spaces with lower 
sort keys in front of spaces with higher sort keys. 

The .space directive is used to declare spaces. The assembly language 
programmer is not required to fill one space before beginning another. 
When a space is first declared, the Assembler begins filling that space. 
The . space directive can also be used to return to a previously declared 
space, and the Assembler continues to fill it as if there had been no 
intervening spaces. 
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Subspaces 

While a space is a fundamental concept of the architecture, a subspace is 
just a logical subdivision of a space. The Assembler places the program's 
code and data into subspaces within spaces. Each subspace belongs to 
the space that was current when the subspace was first declared. The 
linker groups subspaces into spaces as it builds an executable program 
file. For more details seethe ld(l) entry in the H P-UX Rderence. When 
the linker combines several relocatable files, it groups the subspaces 
from each file by name, so that all subspaces with the same name are 
placed contiguously in the program. 

Attributes 

Subspaces have several attributes. The alignment attribute specifies 
what memory alignment (in bytes) is required in the virtual address 
space. The alignment can be any power of two, from 1 through 4096, 
inclusive. Typically, the alignment is 4 or 8 to specify that the beginning 
of the subspace must be word or double-word aligned. Normally, the 
alignment attribute is computed automatically by the Assembler from 
the largest .align directive used within the subspace. 

The quadrant attri bute assigns the subspace to one of thefour quadrants 
of its space. On H P-U X systems, al I subspaces i n the code space must be 
in quadrant 0, and all subspaces in the data space must be in quadrant 
1. 

The access rights attribute specifies the access rights that should be 
given to each physical page in the subspace. On H P-UX systems, all 
subspaces in the code space must have access rights of 0x2c (code page 
executable at any privilege level). All subspaces in the data space must 
have access rights of OxiF (data page readable and writable at all 
privilege levels). 

The sort key attri bute allows the programmer to control the placement of 
a subspace relative to the other subspaces in its space. The linker places 
subspaces with lower sort keys in front of subspaces with higher sort 
keys. 
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Directives 

The . subspa directive is used to declare a subspace and its attributes. 
As with spaces, the assembly language programmer can switch from one 
subspace to another, and the Assembler will fill each subspace 
independently as if the source code had been presented one complete 
subspace at a time. When the . space directive is used to switch spaces, 
the Assembler remembers the current subspace in each space. 

Several additional Assembler directives are provided as shorthand to 
decl are and switch to some standard spaces and subspaces. For example, 
the . code directive switches to the $text$ space and the $code$ 
subspace, and the .data directive switches to the $private$ space and 
the $data$ subspace. 

You can declare as many subspaces as you can use, but the sort key 
attributeshould be used carefully, because the stack unwind mechanism 
reserves a range of sort keys 56 through 255 for the $text$ space. Refer 
to "Compiler Conventions” on page 47 in this chapter. Some of the 
standard subspaces and sort keys used by the compilers are shown in 
Table 3-2 on page 43. Directives that generate commonly used spaces 
and subspaces are found in Table 4-3 on page 116. 


Table 3-2 Standard Subspaces and Sort Keys 


Space 

Subspace 

Sort Key 

Use 

$TEXT$ 


8 



$CODE$ 

24 

Normal code. 


$LIT$ 

16 

Literals. 


$MILLICODE$ 

8 

Mi 11 icode library routines. 


$ SHLIB_INFO$ 

0 

Shared library information. 


$UNWIND$ 

64 

Unwind information. 

$PRIVATE$ 


16 



$BSS$ 

82 

Uninitialized data and common. 


$DATA$ 

16 

Global arrays and structures. 


$DLT$ 

39 

Data linkage table. 
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Space 

Subspace 

Sort Key 

Use 


$GLOBAL$ 

40 

Global variable base address. 


$PLT 

6 

Procedure linkage table. 


$SHLIB_DATA$ 

12 

Shared library data. 


$SHORTBSS$ 

80 

Uninitialized data and common. 


$SHORTDATA$ 

24 

Global scalar variables. 

$THREAD_SPECIFIC$ 


16 



$TBSS$ 

40 

Thread local storage 


Sections in 64^bit Mode 

In 64-bit mode, the Executable and Linking Format (ELF) uses segments 
and sections rather than spaces and subspaces. 

The concept of spaces maps to the ELF concept of segments, but 
segments do not apply to relocatable object files. Flence, the Assembler 
ignores the . space directive for 64-bit assembly programs. Subspaces 
map directly to the ELF concept of sections, so the . subspa directive 
switches to or creates a new section. The attributes of a subspace 
correspond to section attributes as follows: 

• Subspace names I isted i n the table are mapped to thei r correspondi ng 
section name. Names not in this table are unchanged. 


SUBSPACE NAME 

SECTION NAME 

$BSS$ 

.bss 

$CODE$ 

. text 

$DATA$ 

. data 

$FINI$ 

. f ini 
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SUBSPACE NAME 

SECTION NAME 

$INIT$ 

.init 

$LIT$ 

.rodata 

$MILLICODE$ 

. text 

$PREINIT$ 

.preinit 

$SHORTBSS$ 

. sbss 

$SHORTDATA$ 

.sdata 

$TBSS$ 

. tbss 


• The assembler translates access rights into a set of read, write or 
execute permissions for the section. 

• The assembler ignores the sort key and quadrant attributes. 

• The alignment attribute maps directly to the section alignment. 

• The common and dup_comm attributes map to a comdat section. 

• The code_only, first, and frozen attributes are ignored. 

• The unloadable attribute maps to a non-allocated section. 

For more information about ELF, seeELF 64 Object FileFormat, at URL: 
http://www.software.hp.com/STK/. 
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Location Counters 

J ust as spaces can be divided into subspaces, subspaces can be further 
divided by using location counters. You can use up to four location 
counters in each subspace, and the Assembler fills a separate area for 
each location counter. When the assembly is complete, the subspace is 
formed by concatenating each of these areas. All references relative to a 
location counter are relocated so that they are relative to the complete 
subspace. 

Uni ike subspaces, however, the use of location counters is completely 
local to the Assembler. Once the subspace is formed at the end of the 
assembly, the distinction among the individual areas built by location 
counters disappears. Nofurther reordering or grouping related to 
location counters is performed by the linker. 

This facility allows you to assemble related data into disjoint pieces of a 
subspace, while keeping the source code in a convenient order. 

The . locct directive is used to switch from one location counter to 
another. The Assembler automatically remembers the previous value of 
each location counter within each subspace. When the . subspa directive 
is used to switch subspaces, the Assembler automatically begins using 
the location counter that was last in effect in the new subspace. 
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Compiler Conventions 

In order to write assembly language procedures that can both call to and 
be cal led from high-level language procedures, it is necessary to 
understand the standard procedure-calling convention and other 
compiler conventions. 

On many computer systems, each high-level languagehas its own calling 
convention. Consequently, calls from one language to another are 
sometimes difficult to arrange, except through assembly code. The 
architecture generally prescribes very few operations that must be done 
to effect a procedure call, and there is often a pair of machine-language 
instructions to call a procedure and return from one. PA-RISC 
architecture provides no special procedure call or return instructions. 

There is, however, a standard procedure-calling convention for all 
high-level languages as well as the Assembler. It is tuned for the 
architecture, and is designed to make a procedure cal I with as few 
instructions as possible. 

Besides defining a uniform call and return sequence for all languages, 
the calling convention is important for other reasons. I n order to 
streamline the cal ling sequence, the return link is not saved on the stack 
unless necessary and the previous stack pointer is rarely saved on the 
stack. Therefore, it is not usually possible to obtain a stack trace at an 
arbitrary point in the program without some additional static 
information about each procedure's stack frame size and usage. 

For example, you could not obtain a stack trace while debugging or 
analyzing a core dump, or using the try/recover feature in H P 
Pascal/HP-UX. Obtaining a stack trace is made possible by the stack 
unwind mechanism. It uses special unwind descriptors that contain the 
exact static information needed for each procedure. These descriptors are 
generated automatically by the linker based on information provided by 
all high-level compilers as well as the Assembler. 

Each descriptor contains the starting and ending address of a 
procedure's object code, plus that procedure's stack frame size, and a few 
flags indicating, among other things, whether the return link is saved on 
the stack. Given the current program counter and stack pointer, the 
stack unwind mechanism can determine the cal ling procedure by finding 
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the return link either in a register or on the stack. Also, it can determine 
the previous stack pointer by subtracting the current procedure's stack 
frame size. 

The Assembler requires that you follow programming conventions to 
generate unwind descriptors. The beginning and end of each procedure 
must be noted with the .proc and .procend directives. The .callinfo 
directive supplies additional information about the procedure, including 
the stack frame size. The Assembler passes this information to the 
linker, which creates the unwind descriptor. It can also generate the 
standard entry and exit code to create and destroy the stack frame, save 
and restore the return link (if necessary), and save and restore any 
necessary registers. These code sequences are generated at the points 
indicated by the .enter and .leave pseudo-operations. For a more 
thorough discussion of programming conventions, refer to the 64-bit 
Runtime Architecture for PA-RISC 2.0, at URL: 
http://www.software.hp.com/STK/. 

Arguments to procedures are loaded into general registers 26, 25, 24, 
and 23; these registers are named, respectively, %argO, %argi, %arg2, 
and %arg3. If more than four words of arguments are required, the 
remaining arguments are stored in the caller's stack frame in the 
variable argument list. The return value should be returned in general 
register 28, called %retO. General register 29, called %reti, is used for 
the low-order bits of a double-word return value, while %retO contains 
the high order bits. I n addition to the argument and return registers, the 
procedure can use registers 19 through 22 and registers 1 and 31 as 
scratch registers. Any other general registers must be saved before use 
at entry and restored before exit. 

Chapter 4, "Assembler Directives and Pseudo-Operations,"on page 53 
contains detailed descriptions of the Assembler directives described 
above. For a more thorough discussion of the procedure cal ling 
conventions, refer to the topic PA-RISC Architecture at URL: 
http://www.software.hp.com/STK/. 

In order for an assembly language procedure to be cal I able from another 
language or another assembly language module, the name of the 
procedure must be exported. The .export directive does this. It also 
allows you to declare the symbol type. For procedure entry points, the 
symbol type should be entry. 

The Assembler and linker treat all symbols as case-sensitive, whilesome 
compilers do not. By convention, compilers that are case-insensitive 
uniformly convert all exported names to lower case. For example, it is 
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possible to declare a procedure that cannot conflict with HP 
Pascal/HP-UX procedure names by using uppercase letters. However, 
there is an aliasing mechanism in some compilers that allows you to 
declare a case-sensitive name for external use. Seethe appropriate 
language reference manual for more information. 

Conversely, the . import directive allows you to reference a procedure 
name that is exported from another module, either from the Assembler 
or the compiler. Once a procedure name has been imported, it can be 
referenced exactly as if it were declared in the same module. 

Data symbols can be exported and imported just like procedure names. 
However, not all compilers export the names of global variables, or 
provide a mechanism to reference data symbols exported from an 
assembly language module. For example, the H P Pascal/HP-UX compiler 
does not normally do this, whiletheHP C/HP-UX compiler does. HP 
FORTRAN 77/H P-UX named common blocks are exported, but the 
names of the variables within the common blocks are not. 

It was mentioned before that data is allocated beginning from a virtual 
space offset 0x40000000. For convenience as well as compatibility with 
future releases of H P-UX systems, all data in the $private$ space must 
be accessed relative to general register 27, called %dp. EStandard 
run-time start-up code, from the file /usr/ccs/lib/crto . o, must be 
linked with every program. This start-up code declares a global symbol 
called $giobai$ in the $global$ subspace. This code also loads the 
address of this symbol into the %dp register before beginning program 
execution. This register must not be changed during the execution of a 
program. Sincethe%dp register is known to contain the address of 
$giobai$, the foil owing single instruction does the load as long as the 
displacement from $giobai$ to the desired location is less than 8 
kilobytes: 

LDW var-$global$(%dp),%r3 

If the desired location is not known to be close enough to $giobai$, use 
the fol I owi ng sequence: 

Global Symbol Usage 

ADDIL L'var-$global$,%dp ;result in rl 

LDW R'var-$global$(%r1),%r3 
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For convenience, the $SHORTDATA$ and $SHORTBSS$ subspaces can 
be used for small scalar variables. Most scalar variables are close enough 
to $GLOBAL$ so that the shorter form can be used. Arrays and large 
structures should be defined in $DATA$ and the long form used. 

To access items in the $private$ space (global data), the foil owing does 
not work: 

LDIL L'var,%rl ;wrong 

LDW R'var(%rl),%r3 ;wrong 

This example assumes that the operating system always allocates data 
at the same virtual space offset 0x4 0000000. 

Thread local storage (TLS) data is accessed relative to control register 27 
(%cr27). The contents of %cr27 must first be moved to a general register 

by using the mfctl instruction. A symbol,_ tp, is defined, similar to 

$giobai$. The following code shows the loading of the TLS variable. 
Note the similarities between this example and the example "Global 
Symbol Usage"on page 49. 

MFCTL %cr27, &rX 

ADDIL L'var-_tp,%rX ;result in rl 

LDW R'var-_tp(%rl),%r3 

Uninitialized areas in the data space can berequested with the .comm 
(common) request. These requests are always made in the $bss$ 
subspace in the $private$ space. The $bss$ subspace should not be 
used for any initialized data. Common requests are passed on to the 
linker, which matches up all requests with the same name and allocates 
a block of storage equal in size to the largest request. If, however, an 
exported data symbol is found with the same name, the linker treats the 
common requests as if they were imports. 

HP FORTRAN 77/HP-UX common blocks are naturally allocated in this 
way: if a block data subprogram initializes the common block, all 
common requests are linked tothat initialized block. Otherwise, the 
linker allocates enough storage in $bss$ for the common block. The H P 
C/H P-UX compiler also allocates uninitialized global variables this way. 

I n C, however, each uninitialized global is a separate common request. 
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Shared Libraries 

The field selectors t ', lt ', and rt ' are used to write 
position-independent code in assembly language. When you usethese 
selectors and invoke the Assembler with the as command, you must use 
the+z or +z compiler option on the command line. 

Any assembly code that is to be used with shared libraries must follow 
the standard procedure call mechanism as defined in the runtime 
architecture documents under the topic PA-RI SC Architecture at U RL: 
http://www.software.hp.com/STK/. Any external procedures must be 
exported as type entry for the shared library interface to work correctly. 

For more information on position-independent code and shared libraries, 
refer totheFIP-UX Linker and Libraries OnlineUser Guideand the ELF 
64 Object FileFormat, URL: http://www.software.hp.com/STK/. 


Assembly Listing 

The Assembler command-line option, -l, causes an assembly listing to 
standard output. For each line of source code, the listing provides: 

• line number 

• thesubspace offset 

• the hexadecimal representation of the assembled code (possibly 
flagged with an asterisk (*) to indicate address relocation) 

• the source text 

• any comments. 

The following is a line of assembly language as it appears in the source 
file: 

SAVE LDO VAL (%rO),%r20 /retain value 

The above line would appear in the assembly listing as follows: 

line no. offset hex representation label opcode operands comment 

16 0000004c (341400A) SAVE LDO VAL(%r0),%r20 /retain value 
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The choice of line number 16 is arbitrary here. At the end of the 
assembly listing, a symbol table is printed showing the name and value 
of each symbol in the file. A type field for each symbol, indicating either 
absolute or relocatable, is included. 

Certai n types of source I i nes generate mu Iti pie i nstructions. M aero cal Is 
often expand to several instructions. The .enter and .leave 
pseudo-operations can each generate more than one instruction. The 
predefined subspace directives, such as .code and .data, result in a 
space and a subspace declaration. 

You have the choice of listing a section of assembled code in either the 
compressed or expanded form. The placement of the . liston and 
. listoff directives determines which code will be expanded during 
listing. The directive . liston tells the Assembler to expand the listing 
of all subsequent source lines until a . listoff directive is encountered. 
.listoff stays in effect until the occurrence of a .liston directive. 

The default is .liston. 

The directives . liston and . listoff may be placed anywhere in the 
source text and always go into effect immediately. The . liston and 
.listoff directives can be used as often as desired. 
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Assembler directives and pseudo-operations allow you to take special 
programming actions during the assembly process. The directive and 
pseudo-operation names begin with a period (.) to distinguish them from 
machine instruction opcodes or extended opcodes. 


Introduction 

Table 4-1 lists the Assembler directives. Table 4-2 on page 55 lists the 
pseudo-operations. The directives include those that establish the 
procedure-calling convention, declare common, and define spaces and 
subspaces. The pseudo-operations reserve and initialize data areas. 

The remainder of this chapter lists the Assembler directives and 
pseudo-operations in alphabetic order. Several of the descriptions include 
sample assembly code sequences. You can enter these short code 
sequences, assemblethem using the-i option of the as command, then 
inspect the offsets and field values to see how that particular directive 
controls the assembly environment. 

This chapter also includes Table 4-3 on page 116 under "Programming 
Aids" on page 116, which lists the predefined directives that establish 
standard spaces and subspaces. 

Assembler Directives 


Directive 

Function 

.ALIGN 

Forces location counter to the next largest 
multiple of the supplied alignment value. 

.ALLOW 

Used with a . level directive, it temporarily 
allows the use of features in the architecture 
specified in the .level directive. 

.CALL 

Specifies that the next statement is a procedure 
call. 
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Directive 

Function 

.CALLINFO 

Provides information for generating Entry/Exit 
code sequences and for creating stack unwind 
descriptors. 

.COMM 

Requests common storage for a specified number 
of bytes. 

.COPYRIGHT 

1 nserts a string into the object module as a 
copyright notice. 

.END 

Terminates an assembly language program. 

. ENDM 

Marks the end of a macro definition. 

.ENTRY 

Marks the entry point of the current procedure. 

• EQU 

Assigns an expression to an identifier. 

.EXIT 

M arks the return poi nt of the current procedure. 

.EXPORT 

Makes a specified symbol avail able to other 
modules. 

.IMPORT 

Specifies that the definition of the given symbol 
occurs in another module. 

.LABEL 

Permits a label definition to appear within a 
sequence of directives that occur on a single line. 

.LEVEL 

Makes the object file a PA-RISC 1.1, 2.0, or 2.0W 
file. 

.LISTOFF 

Controls listing of expanded Assembler 
instructions. 

.LISTON 

Controls listing of expanded Assembler 
instructions. 

.LOCCT 

Selects a location counter. 

.MACRO 

Marks the beginning of macro definitions. 

.ORIGIN 

Advances the location counter to a relative 
location from the beginning of the current 
subspace. 
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Directive 

Function 

.PROC 

Marks the first statement in a procedure. 

.PROCEND 

Marks the last statement in a procedure. 

.REG 

Attaches a type and number to a user-defined 
register name. 

.SHLIB_VERSION 

Inserts a date string into the object module as a 
shared-library version identifier. 

.SPACE 

Declares a new space or switches back to a 
previous space. 

.SUBSPA 

Declares a new subspace or switches back to a 
previous subspace. 

.VERSION 

Inserts the specified string into the current 
object module as a user-defined version 
identification string. 


Pseudo-Operations 


Directive 

Function 

.BLOCK 

Reserves a block of data storage. 

.BLOCKZ 

Reserves a block of data storage. 

.BYTE 

Reserves 8 bits (a byte) of storage and 
initializes it to the given value. 

.DOUBLE 

1 nitializes 64 bits (a double-word) of storage to 
a floati ng-poi nt val ue. 

.DWORD 

Reserves 64 bits (a double word) of storage and 
initializes it to the given value. 

.ENTER 

Marks a procedure's entry point and generates 
standard entry code. 

.FLOAT 

1 nitializes a single-word of storage to a 
floating-point value. 
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Function 

.HALF 

Reserves 16 bits (a half word) of storage and 
initializes it to the given value. 

.LEAVE 

Marks a procedure's exit point and generates 
standard exit code. 

.SPNUM 

Reserves and initializes a word of storage. 

.STRING 

Reserves the appropriate amount of storage 
and initializes it to the given string. 

.STRINGZ 

Reserves the appropriate amount of storage 
and initializes it to the given string. 

.WORD 

Reserves 32 bits (a word) of storage and 
initializes it to the given value. 
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.ALIGN Directive 

The .align directive advances the current location counter to the next 
specified "boundary." 


Syntax 

.ALIGN [ boundary] 


Parameters 

boundary An integer value for the byte boundary to which you 

want to advance the location counter. The Assembler 
advances the location counter to that boundary. 
Permissible values must be a power of 2 and can range 
from one to 4096. The default value is 8 (double word 
aligned). 

Example 

This sample program adds a 21 bit field to the data pointer. Then a 

branch is taken to the label "page" that has been page-aligned. 

■ CODE 

ADDIL L'$WORDMARK$-$global $,%dp 

B page 

NOP 

.ALIGN 4096 

page 

ADDI 1,%r1,%r1 

.DATA 

$WORDMARK$ 

.WORD OxOFFF 

.IMPORT $global$,DATA 
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.ALLOW Directive 

The .allow directive tel Is the Assembler to temporarily allow PA-RISC 
features from a higher version level of the PA-RISC architecture. The 
.allow directive also tel Is the Assembler to temporarily allow 
implementation-specific features in the assembly source file. 

Syntax 

.ALLOW 1.1 
Lines of source code 
.ALLOW 

Parameters 


l.l Allows PA-RISC 1.1 features. 

2.0 Allows PA-RISC 2.0features. 

Discussion 

Usethe .allow directive with the . level directive. The Assembler uses 
the . level directive to mark the relocatable object file with the proper 
PA-RISC architecture version level. In the source file, the Assembler 
emits warning messages whenever a feature is used that is not 
appropriate for the specified . level directive. 

Usethe .allow directive when it is necessary to include features or 
instructions from a later version of PA-RI SC while leaving the 
relocatable object file marked as an earlier PA-RI SC architecture 
version. For example, usethe .allow directive when you need to 
include PA-RI SC 2.0 features or instructions while leaving the 
relocatable object file marked as a PA-RI SC 1.1 architecture version. 


NOTE A 2.0W parameter is not permitted with .allow, because the code 

generated for 2.0W(64-bit mode) is incompatible with other levels. 
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When using the .allow directive, a run-time check must be inserted 
into the assembly source code. This run-time check should insure that 
the code is executi ng on a PA-RI SC processor that supports the feature 
or features being used after the .allow directive. See the example below. 

An .allow directive without a parameter signals the end of the region 
that the previous .allow directive was controlling. Control is returned 
to the . level specified for the file. 


NOTE The .allow and .level directives replace the +da and +ds 

command-line compiler options. 


Example 

The foil owing example shows how to set a range of memory to 0. I n 
PA-RI SC 1.1 architecture, use the stw instruction. I n PA-RI SC 2.0 
architecture, use the more efficient std instruction. 

.LEVEL 1.1 

; This object file will be marked as a PA 1.1 object file 

; Check what version of PA Architecture we are linked for 
addil LR'_SYSTEM_ID-$global$,%dp 
ldw RR'_SYSTEM_ID-$global$(%rl) , %r5 

ldi CPU_PA_RISC1_1, %r4 

combt,<,n %r4,%r5,$00000002 
; 1.1 specific code 

$00000001 

addib,< 1,%r23,$00000001 
stw,ma %r0,4(%r31) 
b,n $00000003 

; 2.0 specific code 

$00000002 

.ALLOW 2.0 

addib,< 2,%r23,$00000002 
std,ma %r0,8(%r31) 

.ALLOW 
$00000003 
; General code 
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.BLOCK and .BLOCKZ 
Pseudo-Operations 

The .block and .blockz pseudo-operations reserve a block of storage. 

Syntax 

.BLOCK [ num_bytes] 

.BLOCKZ[ num_bytes] 

Parameters 


num_bytes An integer value for the number of bytes you want to 
reserve. Permissible values range from zero to 
0x3fffffff. The default value is zero. 


Discussion 

The .block pseudo-operation reserves a data storage area but does not 
perform any initialization. The .blockz pseudo-operation reserves a 
block of storage and initializes it to zero. 

When you label a. block pseudo-operation, the label refers to the first 
byte of the storage area. 

For large blocks, it is usually better to use the . comm directive to allocate 
uninitialized space. Since . comm storage is allocated at runtime, it 
doesn't increase the size of the object file. 


NOTE U nder the present i mpl ementati on of the Assembl er, the . block 

pseudo-operation also initializes the reserved area to zero. 
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Example 

The first example requests the Assembler to reserve 64 bytes of memory 
in the $code$ subspace. This area isthen followed by a "Load Word" and 
"Store Word" instruction. 

.SPACE $TEXT$ 

.SUBSPA $CODE$ 

.BLOCK 64 

swap LDW 0(%r2)%rl 

STW %r 1,4(%r2) 

.END 

The second example reserves 32 bytes of memory in the $data$ 
subspace foil owed by one word intended as an end marker. 

.DATA 

wordO .BLOCK 0X20 

word8 .WORD OXFFFF 
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.BYTE Pseudo-Operation 

The .byte pseudo-operation reserves storage and initializes it to the 
given value. 

Syntax 

.BYTE [ init_value[ , init_value] ...] 

Parameters 


init_value Either a decimal, octal, or hexadecimal number or a 

sequence of ASCI I characters, surrounded by quotation 
marks. If you omit the initializing value, the Assembler 
initializes the area to zero. 


Discussion 

The . byte pseudo-operation requests 8 bits of storage. If the location 
counter is not properly aligned on a boundary for a data item of that size, 
the Assembler advances the location counter to the next multiple of that 
item's size before reserving the area. 

When you label the pseudo-operation, the label refers to the first byte of 
the storage area. Operands separated by commas initialize successive 
units of storage. 

Example 

The first pseudo-operation allocates a byte labeled e and initializes it to 
the character [ . 

E .BYTE "[" 
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NOTE 


.CALL Directive 

The . call directive marks the next branch statement as a procedure 
call, and permits you to describe the location of arguments and the 
function return result. 

Syntax 

.CALL [ argument_description[ argument_description] ...] 

Parameters 

argument_ 

description Allowsyou to communicate to the linker thetypesof 
registers used to pass floating point arguments and 
receive floating point return results in the succeeding 
procedure call. Similarly, this information can be 
communicated in the .export directive. 

The linker requires this information because the 
runtime architecture allows floating point arguments 
and return values to reside in either general registers 
or floating point registers, depending on source 
language convention. At link time, the linker ensures 
that both the caller and called procedure agree on 
argument location. If not, the linker may insert codeto 
relocate the arguments (or return result) before control 
is transferred to the cal led procedure or a procedure 
return is completed. 

You can use up to 5 argument-descriptions in the 
.call directive; one for each of the four arguments 
that may be passed in registers (arg0-arg3), and one 
for a return value (reto). 

In PA-RISC 2.0W, (64-bit mode) the Assembler ignores the .call 
directive. This means that the linker does not ensurethat the caller and 
called procedure agree on argument locations. If you do not know the 
prototype of the cal led procedure, you must pass floating point 
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parameters in both the corresponding general registers and 
corresponding floating-point registers. Seethe documents under the 
topic PA-RI SC Architecture at URL: http://www.software.hp.com/STK/. 

The form of argument-description is: 

arg=location 

where arg can 
be: 

argwo The first word in the argument list. 

argwi The second word in the argument list. 

argw2 The third word in the argument list. 

argw3 The fourth word in the argument list. 

rtnval The return value for a procedure. 

and location can 
be: 

no The argument word cannot be 

relocated. This should be used for all 
nonfloating-point arguments; it is the 
default when an 

argument-description is omitted. 

gr The argument word occurs in a 

general register. 

fr The argument word occurs in a 

floating point register. 

fu The argument word occurs in the 

upper half of a floating-point register. 


Example 

This example shows the use of the .call directive in 32-bit mode. 
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; This program calls printf() with four arguments 
; whose register locations are described in the .CALL directive. 

; The format string goes into argO, not to be relocated. 

; The string "message" goes into argl, specified as a general register. 

; The floating-point value 57005.57005 goes into farg2, 

; specified as a floating-point register. 

; The hexadecimal number OxfOOd goes into arg3, 

; specified as a general register. 

; The return value from printf() is not to be relocated. 

.LIT 
.ALIGN 
.WORD 
.BLOCKZ 

fp2 .WORD 

• CODE 

main 

.PROC 

.CALLINFO CALLER,FRAME=24,SAVE_RP 
.ENTER 

LDIL L'fp2,%r1 

LDO R'fp2(1),%r31 ; r31 < - floating-point literal address 

FLDWS -16 (%r31) ,%fr4 

LDO -64 (%sp),%rl9 

FSTWS %fr4,0 (%rl9) 

ADDIL L'61453,0 

LDO R'61453(%rl),%r20 

STW %r20,-68 (%sp) ; end of stacking floating-point address 

ADDIL L'string_area-$global$,%dp 

LDO R'string_area-$global$(%r1),%r21 ; point to "message" 

STW %r21,-60 (%sp) ; stack "message" address 

LDO -64(%sp),%r22 

FLDWS 0 (%r22) ,%fr5 

FCNVFF,SGL,DBL %fr5,%fr6 ; convert floating-point value 

ADDIL L'string_area-$global$+8,%dp 

LDO R'string_area-$global$+8(%rl),%arg0 

;point to format string 

LDW -60 (%sp),%argl ; load "message" argument 

FSTDS 38,-16(%sp) 

FLDWS -12 (%sp),%fr6 ; load floating-point argument 

LDWS -16(%sp),%arg3 ; load hexadecimal argument 

LDW -68(%sp),%rl 

STW %r1,-52(%sp) 

.CALL argw0=no,argwl=gr,argw2=fr,argw3=gr,rtnval=no 
BL printf,2 

NOP 
.LEAVE 


8 

1197387154 ; floating-point literal 

12 
0 
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.PROCEND 

.EXPORT main,ENTRY 
.IMPORT printf,CODE 

.DATA 

string_area 

.ALIGN 8 

.STRINGZ "message" 

.STRINGZ "ARGS = %s,%f,%x\n" 

.IMPORT $global$,DATA 
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.CALLINFO Directive 

.callinfo is a required directive that describes the environment of the 
current procedure. The information it provides is availabletothe 
. enter and . leave pseudo-operations to control the entry and exit code 
sequences that they generate. Additional information is used by the 
Assembler to direct the creation of stack unwind descriptors. 

Syntax 

.CALLINFO [ parameter parameter] ...] 
where parameter is one of: 

ALLOCA_FRAME 

ARGS_SAVED 

CALLER 

CALLS 

NO_CALLS 

CLEANUP 

ENTRY_FR=number 

ENTRY_GR=number 

ENTRY_SR=number 

FRAME=number 

HPUX_INT 

MILLICODE 

NO_UNWIND 

SAVE_MRP 

SAVE_RP 

SAVE_SP 

SAVE_SR0 

Parameters 

alloca_frame I ndicates that this procedure allocates temporary 

storage by modifying the stack pointer (%r30). A copy 
of the frame pointer is normally placed in %r3. 
However, if this procedure also has a large frame 
(frame >8191), then the copy of the frame pointer is 
placed in %r4 instead. 

args_saved I ndicates that this procedure stores the arguments into 
the stack frame. 
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CALLER Or 
CALLS 


NO_CALLS 


CLEANUP 

ENTRY_FR= 

register 


ENTRY_GR= 

register 


I ndicates that this procedure calls other routines, so it 
requires space in the stack for a frame marker and a 
fixed argument list. (When a program is assembled 
using the -f option, this becomes the default case.) 

The Assembler allocates stack space when it 
encounters an .enter pseudo-operation and 
deallocates this space when it encounters a . leave 
pseudo-operation. The Assembler allocates 48 bytes for 
the PA-RI SC 32-bit mode and 80 bytes for the PA-RI SC 
64-bit (2.0W) mode. 

The frame marker and fixed argument list area occur 
at the top of the stack so you must take this space i nto 
account when locating local variables on the stack. You 
must allocate an area (using frame=) for a variable 
argument list when this area is needed. 

caller does not i mply the existence of the parameter 

SAVE_RP. 

The caller and calls parameters are equivalent. 

I ndicates that the procedure does not call other 
procedures and, therefore, does not require a frame 
marker on the stack. This is the default case unless the 
program is assembled using the -f option. 

I ndicates that this procedure requires cleanup during 
unwind. 


Specifies the high end boundary of the E ntry/Save 
floating-point register partition. The partition includes 
%fri2 through %fri5 for PA-RI SC 1.0 and %fri2 
through %fr2i for PA-RI SC 1.1. The Assembler 
automatically saves these registers when it encounters 
an . enter pseudo-operation and restores them when it 
encounters a .leave pseudo-operation. 


Specifies the high end boundary of the E ntry/Save 
register partition. The partition may extend over 
registers %r3 through %ri8. If you omit this 
parameter, no registers are saved. 
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When a procedure uses these registers, the Assembler 
saves their values when it encounters an .enter 
pseudo-operation and restores these values when it 
encounters a .leave pseudo-operation. The cal led 
routine saves these registers upon entry and restores 
them upon exit, so values in Entry/Save registers are 
preserved across a procedure call. 

Note: See the description of the frame parameter 
regarding the use of %r3. 

ENTRY_SR= 

register Specifies the high end boundary of the space register 

partition. The partition currently contains only %sr3. 
When the . callinfo directive includes this 
parameter, the Assembler automatically saves the 
Space Register when it encounters an .enter 
pseudo-operation and restores this register when it 
encounters a .leave pseudo-operation. 

FRAME=number Defines thecombined size (in bytes) of the local 

variable area and variable argument area needed by 
the procedure. The . enter pseudo-operation allocates 
the desired space for local variables below the frame 
marker and the . leave pseudo-operation deallocates 
that space. 

The number parameter must be a multiple of eight 
bytes. If a . callinfo directive lacks this parameter, 
the Assembler assumes a default frame size of zero. 

The stack frame includes space for local variables and 
the variable argument area. The size specified for the 
frame should not include space for the stack frame 
marker or the fixed argument area. Allocation of these 
areas is controlled by the caller and no_calls 
parameters. The inclusion of the caller parameter 
always allocates space for the stack frame marker and 
the fixed argument area. (See Table 4-1 on page 53) 

A frame marker is required if the assembly routine 
calls another routine. 
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HPUX_INT 

MILLICODE 

NO_UNWIND 

RP_IN_R31 

SAVE_MRP 

SAVE_RP 


For PA-RI SC 32-bit mode, the frame area is offset from 
the Stack Pointer by 48 bytes because the frame 
marker contains 32 bytes and the fixed argument list 
contains 16 bytes, when both of these areas are 
present. 

For PA-RI SC 2.0W (64-bit mode), the frame area is 
offset from the Stack Pointer by 80 bytes because the 
frame marker contai ns 16 bytes and the fixed 
argument list contains 64 bytes. 

However, the Assembler does not allocate space for the 
frame marker and fixed argument list if the procedure 
does not call any other routines (seetheNO_CALLS 
parameter). 

I f the total frame size for a procedure exceeds 8191 
bytes, the Assembler uses %r3 to locate the previous 
frame marker when it encounters an . enter or 
.leave pseudo-operation. Under these circumstances, 
changing the value of %r3 can cause serious 
consequences. 

Specifies that this procedure is an interrupt procedure. 
This is necessary for the stack unwind mechanism. 

I ndicates to the unwind mechanism that this is a 
millicode routine and it should follow the millicode 
calling conventions. 

This is to be used only in the context of stand-alone 
codeor any procedure that does not need to be reliably 
unwound. 

I ndicates that the return pointer has been moved to 
register %r31 in order to make local millicode cal Is. 
This parameter is only valid for the PA-RI SC 2.0W 
(64-bit mode). 

I ndicates that this millicode procedure saves the 
Millicode Return Pointer (MRP) in its frame marker at 

(SP-20). 

Specifies that the frame marker of the previous routine 
stores the value of the Return Pointer (rp). The 
Assembler automatically saves the Return Pointer 
when it encounters an .enter pseudo-operation, and 
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it restores the rp value when it encounters a . leave 
pseudo-operation. Generally, any procedurethat calls 
other routines should save the rp value. 

save_sp Specifies that the current routi ne saves the val ue of 

Previous_SP in its frame marker at sp-4. Because 
the Assembler does not automatically save the Stack 
Pointer when it generates Entry/Exit code sequences, 
you must explicitly save this value in your program 
when using this keyword. You can obtain the 
Previous_SP value from the special register 
%previous_sp. 

Programming languages, such as HP Pascal/HP-UX, 
typically use this value for up-level display pointers to 
reference local variables. 

save_sro I ndicates that this millicode procedure saves %srO in 
its frame marker at (sp-16) . This parameter is not 
valid for PA-RISC 2.0W (64-bit mode). 


Discussion 

When a program uses the .callinfo directive, all entry and exit code 
must follow the procedure calling convention described in the documents 
under the topic PA-RI SC Architecture at U RL: 
http://www.software.hp.com/STK/. If you use the .enter and .leave 
directives, the Assembler will automatically generate the necessary code. 
The parameters in the .callinfo directive govern the generation of the 
Entry/Exit code sequence (except for save_sp). However, if you use the 
.entry and .exit directives, your code must provide the necessary 
E ntry/Exit code sequences. 

A stack frame consists of a pointer to the top of the frame, a frame 
marker, a fixed argument list, and a variable argument list. The 
following example, Stack Frames, illustrates these areas as an inverted 
stack for PA-RI SC 1.x and 2.0. 


NOTE For PA-RI SC 2.0W, 64-bit mode, the stack frame is different. Refer tothe 

documents under the topic PA-RI SC Architecture at URL: 
http://www.software.hp.com/STK/. 
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Stack Frames 


Variable Arguments 


SP-64 

arg 

word 

7 


SP-60 

arg 

word 

6 


SP-56 

arg 

word 

5 


SP-52 

arg 

word 

4 






Fixed Arguments 

SP-48 

arg 

word 

3 

/ ARG 3 

SP-44 

arg 

word 

2 

/ ARG 2 

SP-40 

arg 

word 

1 

/ ARG1 

SP-36 

arg 

word 

0 

/ ARGO 





Frame Marker 

SP-32 

Saved %r!9 

for shared library calls 

SP-28 

Reserved 



SP-24 

Saved RP 

for shared library calls. 


SP-20: 

Saved RP (or SAVED_MRP). 

SP-16: 

Static Link (or SAVED %srO). 

SP-12: 

Clean Up. 

SP-8 : 

Extension Pointer. Calling stub RP (RP 

SP-4 : 

Previous SP. 


SP: 


Top of Frame 
Stack Pointer. 


Example 

This example uses the C printf () routine (see printf(3S) in HP-UX 
Reference). It illustrates most of the directives to be used when assembly 
language programmers follow the standard procedure calling 
conventions described in the documents under the topic PA-RI SC 
Architecture at URL: http://www.software.hp.com/STK/. 


.CODE ; declare space and subspace 


main 

.PROC 

.CALLINFO CALLER,FRAME=0,SAVE_: 
.ENTER 

ADDIL L'stringinit-$global$,%: 
LDO R'stringinit-$global$(%: 
.CALL 

BL printf,%r2 

NOP 
.LEAVE 
.PROCEND 

.DATA 
stringinit 

.IMPORT $global$,DATA 


; delimit procedure entry 

P ; no local variables, need return 

; insert entry code sequence 

27 ; point to data to be printed 

l),%r26 ; place argument to printf 

; set up for procedure call 

; call printf, remembering from where 

; insert exit code sequence 
; delimit procedure end 

; declare space and subspace 
; mark use of global data subspace 
; get data reference point 
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.CODE 

.EXPORT main,ENTRY 
.IMPORT printf,CODE 
.END 


re-enter code subspace 

make routine known to linker 

external procedure declaration 
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.COMM Directive 

The . comm directive makes a storage request for a specified number of 
bytes. 

Syntax 

label .COMM [ num_bytes] 

Parameters 

label Labels the location of the reserved storage. 

num_bytes An integer value for the number of bytes you want to 
reserve. The Assembler uses a default value of 4 if the 
. comm directive lacks a num_bytes parameter. 
Permissible values range from one to 0x3fffffff. 


Discussion 

The . comm directive declaresa block of storage that can be thought of as 
a common block. You must label every . comm directive. The linker 
associates the label with the subspace in which the . comm directive is 
declared and allocates the necessary storage within that subspace. 
.comm always allocates its space in the $bss$ subspace of the 
$private$ space. If the label of a . comm directive appears in several 
object modules, the linker uses the maximum size specified in any 
module when it allocates the necessary storage in the current subspace. 

Example 

This example reserves 16 bytes of storage for mydata. 

. BSS 

mydata .COMM 16 
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.COPYRIGHT Directive 

The . copyright directive inserts a company name and date into the 

object module as a copyright notice. 

Syntax 

.COPYRIGHT "company-name [, date] " 

Parameters 

company-name, 

date A sequence of ASCI I characters, surrounded by 

quotation marks. The string can contain up to 256 
characters. When a comma follows the company name, 
the next text is expected to be the date. 


Discussion 

The following isthe standard copyright message pi aced in the copyright 
header of the object file: 

Copyright company-name, date. All rights reserved. No 
part of this program may be photocopied, reproduced, or 
transmitted without prior written consent of 

company-name. 

NOTE This directive can appear anywhere in the source file, but may appear 

only once. 
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Example 

This program places a copyright notice in the object file. Once the 
copyright notice is in the object file, the HP-UX utility strings can be 
used to access it. Seestrings(l) in HP-UX Reference 

.COPYRIGHT "My Company Name, 8 Nov 1994" 

.CODE 

.EXPORT main,ENTRY 

main 

.PROC 

.CALLINFO 

.ENTER 

LDI 2,%r5 

ADDI 2,%r5,%r6 

.LEAVE 
.PROCEND 
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.DOUBLE Pseudo-Operation 

The .double pseudo-operation initializes a double-word toa 
floating-point value, calculated from the parameters provided. If the 
location counter, is not aligned on a double-word boundary, it is forced to 
the next multiple of eight. If the statement is labeled, thelabel refers to 
the first byte of the storage area. 

Syntax 

.DOUBLE integer [ .fraction] [ E [ -] power] 

.DOUBLE .fraction [ E[ -] power] 

Parameters 

integer Specifies the whole number part of a decimal number. 

fraction Specifies the fractional part of a decimal number. 

power Specifies the power of ten to raise a decimal number. To 

raise the decimal number to a negative power of ten, 
place a minus sign (-) directly in front of the power 
specified. 

Example 

Each of the foil owing examples initializes two words of memory to 
floating-point quantities: 0.00106 and 400000.0 respectively. 

dec_vall .DOUBLE 10.6E-4 
dec_va!2 .DOUBLE 0.4E6 
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.DWORD Pseudo-Operation 

The .dword pseudo-operation reserves storage and initializes it to the 

given value. 

Syntax 

.DWORD [ init_value[ , init_value] ...] 

Parameters 

init_value An absolute expression, a decimal, octal, or 

hexadecimal number, or a sequence of ASCI I 
characters surrounded by quotation marks. If you omit 
the initializing value, the Assembler initializes the 
area to zero. 


Discussion 

The . dword pseudo-operation requests 64 bits of storage. I f the location 
counter is not properly aligned on a boundary for a data item of that size, 
the Assembler advances the location counter to the next multiple of that 
item's size before reserving the area. 

When you label the pseudo-operation, the label refers to the first byte of 
the storage area. Operands separated by commas initialize successive 
units of storage. 

Example 

The first pseudo-operation advances the current subspace's location 
counter to a double word boundary, al locates a double word of storage 
labeled f and initializes that double word to minus 64 (2s complement). 
The second pseudo-operation initializes a doubleword of storagetothe 
hexadecimal number 6effffffl2345678. 

F .DWORD 64 

.DWORD 0X6effffffl2345678 
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.END Directive 

The .end directive terminates an assembly language program. 


Syntax 

.END 

Discussion 

This directive is the last statement in an assembly language program. If 
a source file lacks an .end directive, the Assembler terminates the 
program when it encounters the end of the file. 


Example 

A file that omitted the last line of this sample program would produce 
identical results. 

■ CODE 

.EXPORT double,ENTRY 
.PROC 

double 

.CALLINFO 

.ENTER 

ADD %argO,%argO,%retO 
.LEAVE 
.PROCEND 
.END 
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.ENDM Directive 

The .endm directive marks the end of a macro definition. The macro 
definition is entered intothe macro table and the remaining source lines 
are read in and assembled. An .endm directive must always accompany 
a .macro directive. 


Syntax 

.ENDM 


Example 

This example defines the macro quadl; it aligns the data specified in the 
macro parameters on quad word boundaries. The .endm directive 
delimits the end of the definition of quadl. 


QUADL 


MACRO 

WD1,WD2,WD3,WD4 

ALIGN 

16 

WORD 

WD1 

ALIGN 

16 

WORD 

WD2 

ALIGN 

16 

WORD 

WD3 

ALIGN 

16 

WORD 

ENDM 

WD4 
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.ENTER and .LEAVE Pseudo-Operations 

The .enter and .leave pseudo-operations mark a procedure's entry 
and exit points. They instruct the Assembler to generate procedure entry 
and exit code sequences based on the information provided in the 
.CALLiNFO directive. 

Syntax 

.ENTER 
Lines of code 
.LEAVE 

Discussion 

The . enter pseudo-operation marks an entry point for the current 
procedure. Every procedure that follows the standard procedure-calling 
convention must contain one .enter pseudo-operation. The cal ling 
conventions are described in the documents under the topic PA-RI SC 
Architecture at URL: http://www.software.hp.eom/STK/.The .leave 
pseudo-operation marks a procedure's exit point. Every procedure that 
follows the procedure-calling convention must contain one . leave 
pseudo-operation. See ".ENTRY and .EXIT Directives" on page 83 for 
exceptions. 

When the Assembler encounters an .enter pseudo-operation, it 
generates an entry code sequence accordi ng to the parameters i n the 
.callinfo directive for that procedure. Similarly, when the Assembler 
encounters a . leave pseudo-operation, it generates an exit code 
sequence according to the parameters in the .callinfo directive for 
that procedure. 
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Example 

This example shows the placement of the .enter and .leave 
pseudo-operations. 

.SPACE $TEXT$ 

.SUBSPA $CODE$ 
entrypt 
.PROC 
.CALLINFO 
.ENTER 

SH1ADD %argO,%argl,%retO 

.LEAVE 

.PROCEND 

.EXPORT entrypt,ENTRY 
.END 
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.ENTRY and .EXIT Directives 

.entry and .exit are compiler generated directives that mark the 
entry point and return point of the current procedure. 


Syntax 

.ENTRY 
Lines of Code 
.EXIT 


Discussion 


The .entry directive signifies that the next instruction is the beginning 
of an entry point for the current procedure. The . exit directive signifies 
that the next instruction initiates a return from the current procedure. 
These directives must be used when . enter and . leave are not 
present, .entry and .exit are optional if the unwind region does not 
have a corresponding entry or exit. Seethe documents under the topic 
PA-RISC Architecture at URL: http://www.software.hp.com/STK/. 

Example 

This example shows a sequence of compiler-generated assembly code. 


.PROC 


.CALLINFO CALLER 
.ENTRY 

STW %r2,-20 (%sp) 

LDO 48 (%sp), %sp 

ADDIL L'$THISMODULE$-$global$,%r27 

.CALL 

BL printf,2 

LDO R'$THISMODULE$-$global$(%rl), 

printf L$exitl 


LDW -68(%sp),%r2 

BV 0 (%r2) 

.EXIT 

LDO -48 (%sp), %sp 

.PROCEND 


; proc entry code follows 
; stack the return pointer 
; set up user stack pointer 
; point to printf data 
; set up for printf call 
; call printf thru RP 
%r26 ; insert argument to 
; hide from linker 
; get callee RP 
; exit thru RP 
; end of exit sequence 
; delete stack frame 
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.EQU Directive 

The .equ directive assigns an expression valueto an identifier. 

Syntax 

symbol ic_name .EQU value 

Parameters 

symbol ic_name The name of the identifier to which the Assembler 
assigns the expression. 

value An integer expression. The Assembler evaluates the 

expression, which must be absolute, and assigns this 
value to symbol ic_name. If the expression references 
other identifiers, each identifier must be defined before 
the .equ directive attempts to evaluate the expression. 


NOTE TheAssembler prohibits the use of relocatable symbols (instruction 

labels) and imported symbols as components of an . equ expression. 


Example 

This is a valid assembly program because the definition of vail comes 
before the definition of vai2. Reversing the first two statements, 
however, produces an error condition. 

vail .EQU 0 
val2 .EQU vall+4 
.SPACE $TEXT$ 

.SUBSPA $CODE$ 

LDW vall,%rl 
STW %r1,val2 
.END 
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.EXPORT Directive 

The .export directive allows symbols to be defined in one program and 
used in other programs. 

Syntax 

.EXPORT symbol [ , type] [ .argument-description] ... 

Parameters 

symbol The name of an identifier whose definition is being 

exported or imported. 

type A linker symbol type that can take one of the foil owing 

values: 


ABSOLUTE 


DATA 


CODE 


ENTRY 


MILLICODE 


Designates an absolute symbol. 

In PA-RISC 2.0W (64-bit mode) 
absolute symbols map to 
stt_notype with a section index of 

SHN_ABS. 

Designates a data symbol. 

I n PA-RI SC 2.0W (64-bit mode) data 
symbols map to stt_object. 

Designates a code location. The 
location can not be a procedure entry. 

I n PA-RI SC 2.0W (64-bit mode) code 
symbols map to stt_object. 

Designates the entry point of a 
procedure. 

I n PA-RI SC 2.0W (64-bit mode) 
entry symbols map to stt_func. 

L ocates code for the entry poi nt of a 
millicode routine. 
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argument- 

description 


MILLI_EXT 

PLABEL 
PRI_PROG 


SEC_PROG 


Locates code for the entry poi nt of an 
external millicode routine. 

Locates a pointer to a procedure. 

Designates the primary program 
entry point. The outer block of H P 
Pascal/H P-U X and the mai n 
program in HP FORTRAN 77/HP-UX 
are type pri_prog. 

In PA-RISC 2.0W (64-bit mode) 
pri_prog symbols map to 

STT_FUNC. 

Designates a secondary program 
entry point. 

In PA-RISC 2.0W (64-bit mode) 
sec_prog symbols map to 

STT_FUNC. 


Allows you to communicate to the linker the types of 
registers used to receive floati ng point arguments and 
return floating point return results. Similarly, this 
information can be communicated in the .call 
directive. 

The linker requires this information, since the 
Procedure Calling Convention described in the 
documents under the topic PA-RI SC Architecture at 
http://www.software.hp.com/STK/ allows floating point 
arguments and return values to reside in either 
general registers or floating point registers, depending 
on source language convention. At link time, the linker 
ensures that both the caller and called procedure agree 
on argument location. If not, the linker may insert code 
to relocate the arguments (or return result) before 
control istransferred tothe called procedure or a 
procedure return is completed. 

The form of argument-description is described in See 
".CALL Directive" on page 63 in this chapter. 
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Discussion 

The . export directive uses a series of keywords to define a symbol to 
the linker. These keywords declare the symbol's type, and its argument 
relocation information if the symbol is the name of a procedure. 

Example 

This example makes the symbol proc avail able to the linker as an entry 
point. It also specifies that the first argument is expected in a general 
register. 

.EXPORT proc,ENTRY,ARGW0=GR 
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.FLOAT Pseudo-Operation 

The .float pseudo-operation initializes a single-word of storage to a 
floating-point value calculated from the parameters provided. If the 
location counter is not aligned on a word boundary, it is forced to the next 
multi pie of four. If the statement is labeled, the label refers to the first 
byte of the storage area. 

Syntax 

.FLOAT integer [ .fraction] [ E [ -] power] 

.FLOAT .fraction [ E [ -] power] 

Parameters 

integer Specifies the whole number part of a decimal number. 

fraction Specifies the fractional part of a decimal number. 

power Specifies the power of ten to raise a decimal number. To 

raise the decimal number to a negative power of ten, 
place a minus sign (-) directly in front of the power 
specified. 


Example 

Each of the foil owing examples initializes one word of memory to 
floating-point quantities: 0.00096 and 3400000.0, respectively. 

factorl .FLOAT 9.6E-4 
factor2 .FLOAT 3.4E6 
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.HALF Pseudo-Operation 

The .half pseudo-operation reserves storage and initializes it to the 

given value. 

Syntax 

.HALF [ init_value[ , init_value] ...] 

Parameters 

init_value Either a decimal, octal, or hexadecimal number or a 

sequence of ASCI I characters, surrounded by quotation 
marks. I f you omit the i niti al i zi ng val ue, the Assembler 
initializes the area to zero. 


Discussion 

The . half pseudo-operation requests 16 bits of storage. I f the location 
counter is not properly aligned on a boundary for a data item of that size, 
the Assembler advances the location counter to the next multiple of that 
item's size before reserving the area. 

When you label the pseudo-operation, the label refers to the first byte of 
the storage area. Operands separated by commas initialize successive 
units of storage. 

Example 

This example allocates two half-words, initializing them to 50 and 100. 
The label b refers to the first half-word allocated. 

B .HALF 50,100 
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.IMPORT Directive 

The . import directive allows symbols to be defined in one program but 
used in other programs. 

Syntax 

.IMPORT symbol [ , type] [ ,TSPECIFIC] 

Parameters 

symbol The name of an identifier whose definition is being 

imported. 

type A linker symbol type that can take one of the foil owing 

values: 


ABSOLUTE 

DATA 

CODE 

ENTRY 

MILLICODE 

MILLI_EXT 

PLABEL 
PRI_PROG 

SEC_PROG 


Designates an absolute symbol. 

Designates a data symbol. 

Designates a code location. The 
location can not be a procedure entry. 

Designates the entry point of a 
procedure. 

Locates code for the entry poi nt of a 
millicode routine. 

Locates code for the entry poi nt of an 
external millicode routine. 

Locates a pointer to a procedure. 

Designates the primary program 
entry point. The outer block of H P 
Pascal/H P-U X and the mai n 
program in HP FORTRAN 77/HP-UX 
are type pri_prog. 

Designates a secondary program 
entry point. 
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tspecific TheTSPECiFic keyword indicates that this isathread 
I oca I storage symbol. 


Discussion 

The . import directive uses a series of keywords to define a symbol to 
the linker. These keywords declare the symbol's type. Because the 
.import directive specifies that another object module contains this 
symbol's formal definition, the Assembler does not associatean imported 
symbol with any particular subspace. When an . import directive lacks 
a type parameter, theAssembler assigns the type of the current subspace 
(either $code$ or $data$) to the symbol. 


Example 

The . import directive lets the Assembler access symname as a 
recognized symbol, even though it is actually defined elsewhere. The 
linker resolves the difference. 


.IMPORT symname,CODE 
.CODE 

LDIL 1/ symname,%rl 
BLE,n R'symname(%sr4 , %rl) 

space. 

NOP 

.END 


;import symname as a CODE symbol. 

;begin CODE subspace 

;call the procedure symname in %sr4 
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.LABEL Directive 

The . label directive permits a label definition to appear within a 
sequence of instructions that occur on a single line. 

Syntax 

.LABEL labelJd 

Parameters 

labeljd Names the label identifier. 

NOTE The . label directive is especially useful when using theM4 macro 

processor or theC preprocessor (cpp). You would normally use this 
directive in a define macro that includes multiple instructions. 


Example 

This example defines a cpp macro named Loop. 

#define Loop(xx) LDO xx(%rO),%rl ! .LABEL Loop ! ADDI,=-l,%rl,%rl \ 
! BL Loop,%r0 ! NOP ! LDI l,%retO ; macro 

.CODE 

step_ten 

.PROC 
.CALLINFO 
.ENTER 
Loop(10) 

.LEAVE 
.PROCEND 

.EXPORT step_ten,ENTRY 
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.LEVEL Directive 

The .level directive tel Is the Assembler which version level of the 
PA-RISC architecture to accept while assembling the source file. The 
.level directive also tel Is the Assembler which implementations- 
specific features are used in the assembly source file. 

Syntax 


.LEVEL 


1.0 
1.1 
2.0 
2.0 W 


Parameters 

1.0 Enables PA-RI SC 1.0 features. This is the default. 

l.i Enables PA-RISC 1.1 features. 

2.0 Enables PA-RI SC 2.0 features. 

2 . ow Enables PA-RI SC 2.0W features and assembles the 

source for a 64-bit machine. 


Discussion 

The Assembler marks the relocatable object file to indicate the minimum 
PA-RISC architecture version level required when executing the object 
code corresponding to the source file. The linker marks the program file 
with the highest version level required by any of the object files linked 
into the program. 

The Assembler uses the . level directive to mark the relocatable object 
fi I e with the proper PA-RISC architecture version level. For example, if 
the code is expected to run only on PA-RI SC 1.1 architectures, a .LEVEL 
1.1 should be inserted at the beginning of the source file. 

To assemble a source fi I e for a PA-RI SC 64-bit system, use a .LEVEL 
2.0W directive as the first directive in the source file. 
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In the source file, the Assembler emits warning messages whenever a 
featureis used that is not appropriate for the specified .level directive. 
The default is to produce a PA-RISC 1.0 relocatable object file. If the 
default is used, any use of PA-RI SC 1.1 or 2.0 features in the assembly 
source file generates a warning messages. 

If the code is expected to run on more than one level of PA-RI SC 
architecture, a run-time check should be used with a .allow directive. 
See ".ALLOW Directive" on page 58 in this chapter for an example of a 
run-time check. 

The . level directive is also used to indicate any 
implementation-specific extensions that the source file depends on. The 
Assembler marks the relocatable object file with information that 
indicates any implementation-specific extensions that were specified in 
the . level directive. The default for an assembly source file is no 
implementation-specific extensions; the Assembler generates warning 
messages if an implementation-specific extension is used. 
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.LISTOFF and .LISTON Directives 

The .listoff and . liston directives control the expansion of 
instructions for all macro invocations, all predefined subspace 
declarations, and the .enter and .leave pseudo-operations, .listoff 
causes the Assembler to cease listing expanded instructions until a 
.liston directive is encountered, .liston causes the Assembler to list 
expanded instructions until a .listoff directive is encountered. 

The default is .liston. 


Syntax 

.LISTOFF 

.LISTON 


Example 

The following is the definition of the macro deck. It is referred to in the 
assembly listing generated when . liston was used with a procedure 
containing the macro invocation. 

DECR .MACRO LAB,VAL 

SKF ADDIL L'VAL-$global$,%dp 

LDW R'VAL-$global$(%rl),%r20 

LAB ADDIBF,=,N -l,%r20,LAB 

. ENDM 

.CODE 

.IMPORT $global$ 

.IMPORT mark 
.IMPORT count 
• PROC 

call_DECR 

.CALLINFO FRAME=0 , SAVE_RP 
.ENTER 

DECR mark,count 

.LEAVE 
.PROCEND 
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If . listoff had been used in the above example, the macro invocation 
decr, and the directives .code, .data, .enter, and .leave, would not 
have been expanded in the assembly listing. 


line offset 

hexcode label 

opcode 

operands (comment) 

1 



.LISTON 


2 



.CODE 





.SPACE $TEXT$, 

SPNUM=0,SORT=0 




.SUBSPA $CODE$, 

QUAD=0,ALIGN=8,ACCESS=0x2c 

3 



.PROC 


4 


call_DECR 

;proc label 

5 



.CALLINFO 

FRAME=0,SAVE_RP 

6 



.ENTER 



00000000 

(6BC23FD9) 

STW 

2 , -0x14(0,OxlE) 


00000004 

(37DE0060) 

LDO 

0x30(OxlE),OxlE 

7 

00000008 

(2B600000) 

ADDIL 

L'count-$global$,%dp 

8 

oooooooc 

(683A0000) 

STW 

%arg0,R'count-$global$(%rl) 

9 



DECR 

mark,count; 





macro invocation 


00000010 

(2B600000) 

ADDIL 

L'VAL-$global$,%dp 


00000014 

(48340000) 

LDW 

R'VAL-$global$(%rl),%r20 



LAB 




00000018 

(AE9F3FF5) 

ADDIBF,= 

-1,%r20,LAB 


0000001C 

(08000240) 

NOP 


10 



.LEAVE 



00000020 

(4BC23F79) 

LDW 

-0x44(0,OxlE),2 


00000024 

(E840C000) 

BV 

0(2) 


00000028 

(37C03FA1) 

LDO 

-0x30(OxlE),0 

11 



.PROCEND 


12 



.EXPORT 

call_DECR,ENTRY 

13 



DATA 





.SPACE $PRIVATE$, 

SPNUM=1,SORT=16 




.SUBSPA $DATA$, 

QUAD=1,ALIGN=8 





ACCESS=0xlf 

14 



.IMPORT 

$global$ 

15 

40000000 

(00000000) count 

.WORD 

0 

16 



.LISTOFF 
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.LOCCT Directive 

The .locct directive specifies where subsequent code should occur in 
one of the four location counters of the current subspace. 

Syntax 

.LOCCT [ loc_number] 

Parameters 

loc_number A location-counter number of the current subspace. 

The permissible values are 0,1, 2, and 3. The default is 
zero. 


NOTE The . locct directive is not permitted within a procedure and cannot be 

used to produce unwindablecode. 


Example 

This example uses two location counters to separate code from data. In 
the assembled code, everything under location counter 0 comes first, 


followed 

by everything under location counter 1, and soon 


■ CODE 
.LOCCT 

0 

ldvall 

LDIL 

L'vail,%rl9 


LDO 

R'vall(%rl9),%rl9 


.LOCCT 

1 

vail 

.WORD 

57005 


.LOCCT 

0 

ldval2 

LDIL 

L'val2,%r2 0 


LDO 

R'val2(%r2 0),%r20 


.LOCCT 

1 

va!2 

.WORD 

61453 
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.MACRO Directive 

The .macro directive marks the beginning of a macro definition. An 
. endm directive must be used to end the macro definition. 

Syntax 

label .MACRO [ formal_parameter[,formal_parameter]...] 

Parameters 

label 

formal_parameter 


Discussion 

Normal Assembler syntax is observed within macro definitions, except 
that text substitution is assumed for formal parameters. The following 
line is an example of a macro declaration: 

DECR .MACRO LAB,VAL 

lab and val are formal parameters. Their actual values are determined 
by the first and second parameters on any invocation of the macro decr. 
On the macro invocation, the parameters are delimited by commas. 
Successive commas indicate a null parameter, causing the expanded 
macro to substitute null for one of its formal parameters. When the 
number of formal parameters exceeds the number of actual parameters, 
null parameters are inserted for the excess parameter positions. When 
the number of actual parameters exceeds the number of formal 
parameters, a warning is issued and the excess parameters are ignored. 


The name of the macro. 

Specifies a string of characters 
treated as a positional parameter. 
The ith actual parameter in a macro 
invocation is substituted for the ith 
formal parameter in the macro 
declaration wherever the formal 
parameter appears in the body of the 
macro definition. 
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NOTE Although there is no upper limit on the number of parameters or 

arguments in a macro definition, no single macro parameter may exceed 
200 characters. 


Macro definitions may appear wherever and as often as necessary within 
source code. Macro definitions may occur inside or outside of spaces, 
subspaces, and procedures. 

Because the Assembler always uses the most recently encountered 
definition, macros may be redefined as often as desired. 


NOTE A macro cannot be defined within the body of another macro definition. 


Although nested macro definitions are not allowed, nested macro calls 
are. A nested macro call occurs when one macro is invoked within the 
definition of another macro. A macro may not be invoked within its own 
definition. Macros can only be invoked after being defined. 

Examples 

The macro definition defines a simple counter or timer called decr. 


DECR 

.MACRO 

LAB,VAL 

SETP 

ADDIL 

L'VAL-$global$, %dp 

LAB 

LDW 

R'VAL-$global$(%rl),%r20 


ADDIBF,= 
NOP 
. ENDM 

-1,%r20,LAB 


The following is an invocation of decr: 


DECR LOOP,COUNT 

loop and count are the actual parameters that are specific to this 
particular invocation of the macro decr. 

During macro expansion, textual substitution for positional parameters 
is performed in the body of the macro definition. Substitution is 
performed on strings of characters that are delimited by blanks, tabs, 
commas, or semicolons. If the string matches one of the formal 
parameters, it is replaced with the corresponding actual parameter. 

When a macro definition contains a label, the expanded form of the 
macroaddsa unique suffix to the label for each instance the macro is 
invoked. This unique suffix prevents duplicate symbols from occurring 
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and prevents the label from being referenced from outsidethe body of the 
macro definition. This suffix also contains a number that is used as a 
counter by the Assembler. 

The following example defines the macro print, which calls the 
printf () function (see printf(3S) in H P-UX Reference). The macro 
parameter data_addr is used to set up the argument to be passed to 

printf() . 

PRINT .MACRO 
ADDIL 
.CALL 
BL 
LDO 
. ENDM 

The next example defines the macro store, store places the contents of 
the register reg, the first macro parameter, into the memory address 
loc, the second parameter. 

STORE .MACRO REG,LOC 

LDIL L'LOC-$global$,%rl 

STW REG,R'LOC-$global$(%r1) 

.ENDM 


DATA_ADDR 
L'DATA_ADDR,%dp 

printf,%rp 

R'DATA_ADDR(%rl),%argO 
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.ORIGIN Directive 

The .origin directive advances the location counter to the specified 
location. 

Syntax 

.ORIGlN [ location] 

Parameters 

location The integer value used to advance the location counter 

to that absolute location. The location counter value 
may not decrease during this process; that is, the value 
specified cannot be less than the value of the current 
location counter. 

The default value is zero. 


Discussion 

When the Assembler encounters an .origin directive, it issues a 
.block pseudo-operation of a size calculated to advance the location 
counter to the requested origin. See ".BLOCK and .BLOCKZ 
Pseudo-Operations" on page 60 in this chapter. 


Example 

This sample program performs an exclusive or, advances the location 
counter to 64 bytes, and branches to the label idx. 

■ CODE 

XOR %r21,%r22,%r23 

B idx 

NOP 

.ORIGIN 64 

idx LDWX %r23(%srO,%srO),%r3 

.END 
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.PROC and .PROCEND Directives 

The .proc and .procend directives bracket the instructions within a 
procedure. 

Syntax 

.PROC 

Lines of Code 
.PROCEND 

Discussion 

The .proc directive signifies that the next instruction is the first 
instruction of a procedure. The .procend directive signifies that the 
previous instruction wasthelast instruction of the procedure. Switching 
spaces or subspaces within a procedure is not permitted. 

Every procedure must contain a .callinfo directive and normally 
contains an .enter and .leave pseudo-operation. The only exception to 
thelatter ruleoccursin procedures that are either compiler-generated or 
created by programmers who are writi ng thei r own entry and exit code 
sequences. I n this case, you must use the . entry and .exit compiler 
directives. 


NOTE Because the .enter and .leave pseudo-operations guarantee that the 

stack unwind process works correctly, you should consistently use these 
directives rather than writing your own entry and exit code sequences. 
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Example 

This template shows a procedure that follows the procedure-calling 
convention. 

■ CODE 

test 

.PROC 

.CALLINFO 

.ENTER 

COMCLR,= %argO,%argl,%retO 

LDI 1,%retO 

.LEAVE 

.PROCEND 

.EXPORT test 
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.REG Directive 

The .reg directive assigns a predefined or user-defined typed-register to 
a symbol, which becomes a synonym for the typed-register. 

Syntax 

label .REG [ typed_register] 

Parameters 

label A user-defined register name. 

typed_register M ust be one of the predefined Assembler registers or a 
previously defined user-defined register name All 
predefined Assembler registers begin with %. 

Example 

This example defines the register shift as a synonym for control 
register eleven. %sar is a predefined synonym for control register eleven, 
the shift-amount register. 

shift .REG %sar 
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.SH LI B_VE RSI ON Directive 

The . shlib_version directive marks the object file with a version 
stri ng that the shared I i brary understands. 

Syntax 

.SHLIB_VERSI ON " mm/yyyy" 

Parameters 

mm The one- or two-digit number of the month, 

yyyy The four-digit number of the year. 

Example 

The following pseudo-operation pi aces the date September 1994 in the 
object file. 

.SHLIB_VERSION "9/1994" 
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.SPACE Directive 

The . space directive starts a new space or switches back to an old 
space. The Assembler ignores the .SPACE directive for 64-bit assembly 
programs. For more information, see "Sections in 64-bit Mode" on page 
44. 

Syntax 


-.NOTDEFINED- 
,PRIVATE 


.SPACE name 


,SORT =val ue 
,SPNUM=value 


,TSPECI FIC 
_,UNLOADABLE_ 


Parameters 


name 

NOTDEFINED 

PRIVATE 


S0RT=value 


SPNUM=value 


An identifier that names the new space. 

Specifies that the definition for this space occurs in 
another object module. 

Specifies that other programs cannot sharethe data in 
this space. The enforcement of this directive depends 
on the operati ng system. 

Provides an integer value for the sort key. The linker 
orders the spaces in the output object module according 
to this key. It is suggested that the number "8" be used 
for space $text$ and the number "16" be used for 

$PRIVATE$. 

A space number constant that provides a specific 
number for the current space. Its use is currently 
optional and is ignored by thelinker. If the first 
parameter of the . space directive is an integer, it will 
be interpreted as the space number and any remaining 
parameters will be ignored. 
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tspecific I ndicates that this space contains thread local storage 
data. 

unloadable Specifies that the space resides on disk and is not 

loadable into main memory. Debugger data is a typical 
example of an unloadable space. 


Discussion 

The first time the Assembler encounters a . space directive with a new 
name; it uses that name to declare a new space. As this is the defining 
occurrence of that space, additional keywords can describe attributes for 
that space. 

If the Assembler encounters subsequent .space directives with that 
name; it continues that space. I n this case, wherethe program is 
re-entering a previously defined space, the . space directive can only 
contain the space name; other keywords to describe the space are illegal. 

A space can contain from one to four discrete quadrants (See the quad 
parameter of the . subspa directive.) When you divide a space into 
multiple quadrants, you must define all the subspaces within each 
quadrant as a group. If subspaces for a quadrant are defined 
individually, program operation is unpredictable. The Assembler, 
however, does not check for this condition. 

Example 

This example shows some of the standard "space" definitions in a typical 
assembly language program. 

.SPACE $TEXT$, SPNUM=0, SORT = 8 

.SPACE $PRIVATE$, SPNUM=1,PRIVATE,SORT=l6 

.SPACE $myspace$, SPNUM=7,UNLOADABLE 

.SPACE $THREAD_SPECIFIC$, PRIVATE, TSPECIFIC, SORT=32 
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.SPNUM Pseudo-Operation 

The . spnum pseudo-operation reserves a word of storage and initializes 
it with the space number of the space named by the operand. Only one 
operand is allowed and any label present is offset at the first byte of the 
storagejust initialized. 

Syntax 

.SPNUM name 

Parameters 

name Specifies the name of a space whose space number is 

used to initialize a word of storage. 

NOTE Space numbers are ignored by the linker. 


Example 

In thisexample, the space number of $private$, l, isstored as the 
address of the symbol log by the . spnum pseudo-operation. 


.SPACE 
.SUBSPA 

data_ref 

.WORD 

LOG .SPNUM 


$PRIVATE$,SPNUM=1 
$DATA$,QUAD=1, 


SORT=l6 

ALIGN=8,ACCESS=Oxlf 

OxFFFF 

$PRIVATE$ 


SORT=24 
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.STRING and .STRINGZ 
Pseudo-Operations 

The . string pseudo-operation reserves storage for a data area and 
initializes it to ASCI I values. The .stringz pseudo-operation reserves 
storage the same as . string, but appends a zero byte to the data. This 
creates a C-language-type string. If the statement is labeled, the label 
refers to the first byte of the storage area. 

Syntax 

.STRING "init_value!' 

.STRINGZ "init_value" 

Parameters 

init_value A sequence of ASCI I characters, surrounded by 

quotation marks. A string can contain up to 256 
characters. The enclosing quotation marks are not 
stored. 

The fol Iowi ng escape sequences can be used to 
represent characters: 


\" 

Quotation mark 

\0 

Null (=\x00; ASCII NUL) 

\\ 

Backslash 

\b 

Backspace (=\x08; ASCI 1 BS) 

\f 

Form feed (=\xOC; ASCI 1 FF) 

\n 

Newline (=\xOA; ASCI 1 LF) 

\r 

Carriage return (=\x0d; ASCII CR) 

\t 

Tab (=\x09; ASCII HT) 

\xhh or\xhh 

Any 8-bit character; hh is two 
hexadecimal digits. 


Chapter 4 


109 




Assembler Directives and Pseudo-Operations 

.STRING and .STRINGZ Pseudo-Operations 


Discussion 

The . string pseudo-operation requests the required number of bytes to 
store the string (where each character is stored in a byte). The . stringz 
pseudo-operation also requests the required storage for the quoted string 
but then appends a zero byte for compatibility with C language strings. 

When you label one of these pseudo-operations, the label refers to the 
first byte of the storage area. 

Examples 

This pseudo-operation allocates eight bytes, the first of which is labeled 
G. Then it initializes this area with the characters: a, space; s, t, r, i, n, 
and G. 

G .STRING "A STRING" 

This pseudo-operation allocates eight bytes to hold a string, allocates 
an additional byte for the appended zero, and associates the label g with 
the first byte of the storage area. 

G .STRINGZ "A STRING" 
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.SUBSPA Directive 

The .subspa directive declares a new subspace or switches back to an 
old subspace. I n 64-bit assembly programs subspaces map directly to the 
ELF concept of sections, so the . subspa directive switches to or creates 
a new section. For more information, see "Sections in 64-bit Mode" on 
page 44. 

Syntax 


.SUBSPA name 


-,ACCESS=value 
,ALIGN=value 
,CODE_ON LY 
.COMMON 
,DUP_COMM 
.FIRST 
.FROZEN 
.LOCK 

,QUAD=val ue 
.SORT =val ue 


.TSPECIFIC 

.UNLOADABLE 

.ZERO 


Parameters 


name An identifier that names the current subspace. 

ACCESS=value Specifies the 7-bit value for the access rights field in 
the pdir (Physical Page Directory for virtual address 
mapping). Must be 0x2c for code, and Oxif for data 
subspaces. 


ALiGN=value Specifies a value (which must be a power of 2) on which 
the Assembler should align the beginning of the 
subspace. The default value is the largest alignment 
requested within that subspace, or one if no alignment 
requests exist. 
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CODE_ONLY 

COMMON 

DUP_COMM 


FIRST 

FROZEN 

LOCK 

QUAD=value 

S0RT=value 


TSPECIFIC 

UNLOADABLE 


ZERO 


Specifies that this subspace contai ns only code. 

Specifies that this subspace is a common block. 

Specifies that the initialized data symbols within this 
subspace can have duplicate names. When you include 
this parameter, multiple occurrences of a universal 
data symbol can exist and the linker does not report a 
"Duplicate Definition" error. 

Specifies that the subspace must be allocated exactly at 
the beginning of the specified space. 

I f set, the subspace is locked i nto physical memory 
when the subspace goes into execution. 

If set, the subspace is locked into physical memory 
when the operating system is booted. 

Specifies the quadrant (0 through 3) in which the 
Assembler should place this subspace. The default 
value is zero. 

Provides an integer value for the primary sort key. The 
linker orders the subspaces in theoutput object module 
according to this primary key. If several subspaces 
share the same primary key value, the linker lists 
these subspaces in the order in which it processes 
them. It is suggested that 24 be used for both code and 
data subspaces. 

I ndicates that this space contains thread local storage 
data. 

Specifies that this subspace is not loadable into 
memory. Loadable subspaces must reside in loadable 
spaces, and unloadable subspaces must reside in 
unloadable spaces. 

Specifies that this subspace contai ns all zeros and no 
data appears in theoutput file. 
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.SUBSPA Directive 

Discussion 

Thefirst time the Assembler encounters a . subspa directive with a new 
name; it uses that name to declare a new subspace. As this is the 
defining occurrence of that subspace, optional keywords describe 
attributes of that subspace. 

When the Assembler encounters additional . subspa directives with that 
name; it continues that subspace. I n this case, the . subspa directive can 
only contain the subspace name; other keywords to describe the subspace 
are illegal. 

Example 

This example shows some of the standard "subspace" definitions in a 
typical assembly language program. 

.SUBSPA $CODE$, QUAD=0, ALIGN=8, ACCESS = 0x2c, SORT=24, CODE_ONLY 

.SUBSPA $DATA$, QUAD=1,ALIGN=8,ACCESS=Oxlf,SORT=l6 

.SUBSPA $TBSS$, QUAD=1,ALIGN=8,ACCESS=Oxlf,ZERO, TSPECIFIC, SORT=40 
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.VERSION Directive 

The .version directive places the designated string in the current 
object module for version identification. 

Syntax 

.VERSION "info_string" 

Parameters 

info_string A sequence of ASCI I characters, surrounded by 

quotation marks. The string can contain up to 256 
characters. 


Discussion 

The Assembler places this string in the current object module. A 
program can contain multiple .version directives. 

Once the version information is in the object file, the H P-UX utility 
strings can be used to access it. Seestrings(l) in HP-UX Rderence 


NOTE This directive can appear anywhere in the source file, and multiple 

occurrences are permitted. 


Example 

This program inserts version information intotheobject module, and 
performs subtract and deposit operations. 

■ CODE 

.VERSION "Version 1 of This Simple Sample Program" 

SUB %rl9,%r20,%rl9 

DEP %rl9,14,5,%r22 

.END 
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.WORD Pseudo-Operation 

The .word pseudo-operation reserves storage and initializes it to the 

given value. 

Syntax 

.WORD [ init_value[ , init_value] ...] 

Parameters 

init_value A relocatable or absolute expression, a decimal, octal, 

or hexadecimal number, or a sequence of ASCI I 
characters surrounded by quotation marks. If you omit 
the initializing value, the Assembler initializes the 
area to zero. 


Discussion 

The .word pseudo-operation requests 32 bits of storage. If the location 
counter is not properly aligned on a boundary for a data item of that size, 
the Assembler advances the location counter to the next multiple of that 
item's size before reserving the area. 

When you label the pseudo-operation, the label refers to the first byte of 
the storage area. Operands separated by commas initialize successive 
units of storage. 

Example 

The first pseudo-operation advances the current subspace's location 
counter to a word boundary, allocates a word of storage labeled f and 
initializes that word to minus 32 (2's complement). The second 
pseudo-operation initializes a word of storage to the hexadecimal 
number 6EFF1234. 

F .WORD -32 

.WORD 0X6eff1234 
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Programming Aids 

The Assembler provides a series of standard space and subspace 
definitions that you can use to simplify the writing of an assembly 
program. These definitions are duplicated in the system file 
/usr/iib/pcc_prefix. s. Because this file is relatively large and may 
change with new releases of the Assembler, you can vi ew the most recent 
version of the file on your terminal screen by typing the command: 

more /usr/lib/pcc_prefix.s 

Table 4-3 on page 116 lists the predefined directives for establishing 
standard spaces and subspaces. 


Table 4-3 Predefined Subspace Di rectives 


Directive 

Space Name 

Default Parameters 

. BSS 

.space $PRIVATE$,'' 
.subspa $BSS$, 

PRIVATE,SPNUM=1,S0RT=16 

QUAD=1,ALIGN=8,ACCESS=Oxlf, SORT=82,ZERO 

.CODE 

.space $TEXT$, ' ' 
.subspa $CODE$, 

SPNUM=0,S0RT=8 

QUAD=0,ALIGN=8,ACCESS=0x2c,SORT=24 

.DATA 

.space $PRIVATE$, ' ' 
.subspa $DATA$, 

PRIVATE,SPNUM=1,S0RT=16 

QUAD=1,ALIGN=8,ACCESS=0xlf,SORT=24 

.FIRST 

.space $TEXT$,'' 
.subspa $FIRST$, 

SPNUM=0,S0RT=8 

QUAD=0,ALIGN=2048,ACCESS=0x2c, S0RT=4,FIRST 

.GATE 

.space $TEXT$, 1 ' 
.subspa $GATE$, 

SPNUM=0,S0RT=8 

QUAD=0,ALIGN=8,ACCESS=0x4c, 

SORT=84,CODE_ONLY 

.GLOBAL 

.space $PRIVATE$,'' 
.subspa $GLOBAL$, 
.IMPORT $global$ 

PRIVATE,SPNUM=1,S0RT=16 

QUAD=1,ALIGN=8,ACCESS=0xlf,SORT=40 

. GNTT 

.space $DEBUG$,'' 
.subspa $GNTT$, 

SPNUM=2,PRIVATE,UNLOADABLE,S0RT = 8 0 
ALIGN=4,ACCESS=0,UNLOADABLE 

. HEADER 

.space $DEBUG$,'' 
.subspa $HEADER$, 

SPNUM=2,PRIVATE,UNLOADABLE,SORT = 8 0 

ALIGN=4,ACCESS=0,UNLOADABLE,FIRST 

. HEAP 

.space $PRIVATE$, ' ' 
.subspa $HEAP$, 

PRIVATE,SPNUM=1,S0RT=16 

QUAD=1,ALIGN=8,ACCESS=Oxlf,SORT=82 

.LIT 

.space $TEXT$,' 1 
.subspa $LIT$, 

SPNUM=0,S0RT=8 

QUAD=0,ALIGN=8,ACCESS=0x2c,S0RT=16 
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Directive 

Space Name 

Default Parameters 

. LNTT 

.space $DEBUG$,'' 
.subspa $LNTT$, 

SPNUM=2,PRIVATE,UNLOADABLE,SORT = 8 0 
ALIGN=4,ACCESS=0,UNLOADABLE 

. MILLICODE 

.space $TEXT$, 1 1 
.subspa $MILLICODE$, 

SPNUM=0,SORT=8 

QUAD=0,ALIGN=8,ACCESS=0x2c,SORT=8 

. PCB 

.space $PRIVATE$,'' 
.subspa $PCB$, 

PRIVATE,SPNUM=1,SORT=l6 

QUAD=1,ALIGN=8,ACCESS=OxlO,SORT=82 

.REAL 

.space $TEXT$,'' 
.subspa $REAL$, 

SPNUM=0,SORT=8 

QUAD=0,ALIGN=8,ACCESS=0x2c, 

SORT=4,FIRST,LOCK 

.RECOVER 

.space $TEXT$, ' ' 
.subspa $RECOVER$, 

SPNUM=0,SORT=8 

QUAD=0,ALIGN=4,ACCESS=0x2c,SORT=80 

.RESERVED 

.space $TEXT$, 11 
.subspa $RESERVED$, 

SPNUM=0,SORT—8 

QUAD=0, ALIGN=8,ACCESS=0x73,SORT=82 

. SHORTDATA 

.space $PRIVATE$,'' 
.subspa $SHORTDATA$, 

PRIVATE,SPNUM=1,SORT=l6 

QUAD=1,ALIGN=8,ACCESS=0xlf,SORT=16 

. SLT 

.space $DEBUG$,'' 
.subspa $SLT$, 

SPNUM=2,PRIVATE,UNLOADABLE,SORT = 8 0 
ALIGN=4,ACCESS=0,UNLOADABLE 

. STACK 

.space $PRIVATE$,'' 
.subspa $STACK$, 

PRIVATE,SPNUM=1,SORT=l6 

QUAD=1, ALIGN=8,ACCESS=Oxlf,SORT=82 

.UNWIND 

.space $TEXT$,' 1 
.subspa $UNWIND$, 

SPNUM=0,SORT=8 

QUAD=0,ALIGN=4,ACCESS=0x2c,SORT=64 

H 

> 

.space $DEBUG$,'' 
.subspa $VT$, 

SPNUM=2,PRIVATE,UNLOADABLE,SORT = 8 0 
ALIGN=4,ACCESS=0,UNLOADABLE 
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Pseudo-Instruction Set 


I n addition to the PA-RI SC instruction set, which is described in 
PA-RISC 1.1 Architecture and Instruction Set Reference Manual and 
PA-RI SC 2.0 Architecture the Assembler provides a number of 
pseudo-instructions that perform commonly used forms of the basic 
instructions. These pseudo-instructions are listed with their 
standard-instruction format in Table 5-1 on page 120. 

When coding branch instructions, including those with nullification 
specified, pay attention to the instruction that follows the branch in the 
source code. All branch instructions consider this foil owing instruction to 
be in their delay slot. You can use a nop pseudo-instruction to fill the 
delay slot when there is no other useful work to be performed. This delay 
slot is usually executed. 



Pseudo-Instruction Set 


Table 5-1 Pseudo-Instructions 


Pseudo-Instruction Format 

Standard Instruction Format 

ADDB, cond, n 1, 2 

rl,r2,target 

ADDBT,cond,n 
ADDBF,cond,n 

rl, r2,target 
rl, r2,target 

ADDIB, cond, n^' 2 

rl,r2,target 

ADDIBT, cond, n 
ADDIBF,cond, n 

rl, r2,target 
rl, r2,target 

B 

w 

BL 

w, %r0 

COMB, cond, n 1, 2 

rl,r2,target 

COMBF,cond,n 
COMBT, cond, n 

rl, r2,target 
rl, r2,target 

COMIB, cond, n 1 ' 2 

rl,r2,target 

COMIBF,cond, n 
COMIBT,cond, n 

rl, r2,target 
rl, r2,target 

COPY 

r, t 

LDO 

0(r) , t 

LDI 

i, t 

LDO 

i (%r0) , t 

MTSAR 

r 

MTCTL 

r, %crl 1 

NOP 

OR 

%r0,%r0,%r0 


1. The cond completer determines the actual instruction that the Assembler uses 
in the conditional branch. TheT form is used with nonnegated completers. The 
f form is used with negated completers. See Table 5-2 on page 121 and 
Table 5-3 on page 122 for details. 

2. n indicates an optional nullification completer. 
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Table 5-2 


Compare and Branch Conditions (COMB and COMIB) 


cond 

Description 



never 


= 

opdi is equal to opd2 


< 

opdi is less than opd2 (signed) 


< = 

opdi is less than or equal to opd2 (signed) 

Non negated 

<< 

opdi is less than opd2 (unsigned) 


<< = 

opdi is less than or equal toopd2 (unsigned) 


sv 

opdi minus opd2 results in overflow (signed) 


OD 

result of opdi minus opd2 is odd 


TR 

always 


<> 

opdi is less than or greater than opd2 


>= 

opdi is greater than or equal to opd2 (signed) 


> 

opdi is greater than opd2 (signed) 

Negated 

>>= 

opdi is greater than or equal to opd2 (unsigned) 


>> 

opdi is greater than opd2 (unsigned) 


NSV 

opdi minus opd2 results in no overflow (signed) 


EV 

result of opdi minus opd2 is even 
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Table 5-3 


Add and Branch Conditions (ADDB and ADDIB) 


cond 

Description 



never 


= 

opdi is equal to -opd2 


< 

opdi is less than -opd2 (signed) 


<= 

opdi is less than or equal to -opd2 (signed) 

Non negated 

NUV 

opdi +opd2 < 2 32 (no unsigned overflow) 


ZNV 

opdi +opd2 <2 3 " or opdi +opd2 =0 


SV 

opdi plus opd2 results in overflow (signed) 


OD 

result of opdi plus opd2 is odd 


TR 

always 


<> 

opdi is not equal to -opd2 


> = 

opdi is greater than or equal to -opd2 (signed) 


> 

opdi is greater than -opd2 (signed) 

Negated 

uv 

opdi +opd2 > = 2 32 (unsigned overflow) 


VNZ 

opdi +opd2 >2 3 " and opdi +opd2 not =0 


NSV 

opdi plus opd2 results in no overflow (signed) 


EV 

result of opdi plus opd2 is even 
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Assembling Your Program 


This chapter describes two different ways you can invoke the Assembler 
and the various command line options control ling its behavior. It also 
contains a brief description of the interface between the Assembler and 
linker, and things you should remember to facilitate the running of an 
assembly program. 


I nvoki ng the Assembler 

You can invoke the Assembler directly by using the as command. Or, you 
can invoke the Assembler through the cc command, which processes the 
assembly source usi ng the C preprocessor. The next two sections descri be 
these pathways. 
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Using the as Command 

The as command is the standard command for invoking the Assembler 
on PA-RI SC systems running on H P-UX. See as(l) in H P-UX Rd'erence 
for complete details. 

If no files are specified, the Assembler reads source text from standard 
input, which must be a command-line pipe or a FIFO. It cannot be a 
device file, such as a terminal. 

The Assembler produces a singleoutput file (seethe -o option). If the 
source text is read from standard input, the object file is written to 
standard output and the -o option is ignored. 

The as command resides in the /usr/ccs/bin directory. 

If your programming environment does not establish a path to this 
directory, you must include the path name as the first part of the as 
command. For example: 

/usr/ccs/bin/as -1 line.s box.s draw.s 

Syntax 

as [ [ option] ...[ file] ...] ... 

Parameters 

file The name of an input file. The name must include the 

suffix . s. If you specify multiple input files, they are 
concatenated in order. 

option A flag telling the Assembler to take some special 

action. All options affect all input files. The as 
command supports the folIowing options. 


+DAarch . Assemble code for the architecture 
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-f 


-1 


-o filename 


-p level 


-s 


Assembling Your Program 

Using the as Command 


specified. The use of this option is 
discouraged. The preferred method for 
selecting the architecture is to use a 
. level directive in the assembly 
source file. 

The target architecture specified with 
the . level di rective takes precedence 
over the architecture specified with the 
+da option. 

Specify that the Assembler should 
tolerate one million errors before 
terminating the assembly process. 
Without this option, the Assembler 
terminates a program after 100 errors. 

Specify that procedures call other 
procedures as the default condition. 
Normally, the Assembler assumes that 
procedures do not call other procedures. 
(See the calls and no_calls 
parameters for .callinfo directive.). 

List the assembled program on 
standard output. This listing shows 
instruction offsets and the values 
stored in each field. 

Assign the specified name to the output 
file. The default name for the output 
file is the name of the last input file 
with the suffix changed to . o. 

Specify the privilege level of running 
capability. I a/el must be in the range 
zero to three, with three being the least 
privileged (normal user). 

Set the output file suffix to . ss 
instead of . o. The file will have a 
format suitable for conversion to the 
ROM burning programs. 
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-u 


-v filename 


-v 


-w[number] 


+ z 


+ Z 


Prevent the Assembler from creati ng 
stack unwind descriptors. This option 
precl udes the use of the . enter and 
.leave directives within a program. 

Name a file to which the Assembler 
writes cross-reference information; 
this includes the source file and the line 
number for each appearance of all 
symbols. 

Print the version number of the 
Assembler program to standard error 
before assembl i ng the source text. 

Either suppress all warning messages 
if nonumber is supplied or suppress 
just the warning number provided. You 
can use multiple -wnumber options 

to suppress additional warning 
messages. 

Create position-independent code 
suitablefor inclusion in a shared 
library. Use this option for small 
linkage tables. 

Create position-independent code 
suitablefor inclusion in a shared 
library. Use this option for large 
linkage tables. 

For more information about linkage 
tables, seeHP-UX Linker and Libraries 
OnlineUser Guide. 
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Using the cc Command 

You can also use the cc command to run the Assembler on files that have 
a . s suffix. Seecc(l) man page for the H P C/H P-UX ANSI C compiler, if 
installed. The cc command inserts the system file 

/usr/lib/pcc_prefix . s 

in front of the . s fileand pipes the file through theC preprocessor (see 
cpp(l) in HP-UX Rd'erence) before passing the file to the Assembler. 
pcc_pref ix. s is a concatenation of the foil owing header files in the 
directory /usr/inciude: 

hard_reg. h Set of . regs for hardware registers. 

soft_reg. h Set of register definitions that follows the Procedure 
Calling Convention. 

std_space. h Set of space and subspace definitions that most 
Assembler programs use. 

NOTE I f you are usi ng the H P C/H P-U X AN SI C compi I er, you can suppress the 

pcc_pref ix. s file with the cc option +a. 


Passing Arguments to the Assembler 

The cc command normal Iy stri ps al I as command options from the 
command line, writing a warning to standard error. Therefore, when you 
want to retai n one of these opti ons, you must i ncl ude the -Wa 
command-1 i ne opti on 

-Wa, ,as-argument [ as-argument] ... 

as-argument names an Assembler argument you want to preserve. For 
example, to specify a cross-reference file, you could use: 

-Wa,-v,myxreffile 

Similarly, you can pass options totheC preprocessor (cpp) or the linker 
(id) with -Wp and -wi, respectively. 
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cpp Preprocessor 

You can use the C preprocessor (cpp) with assembly language programs 
to include C-type macros, including directives. You can use an 
exclamation point (!) as a statement terminator to include multiple 
statements in the body of one macro definition. Furthermore, you can use 
the .label directive to declare labels within a macro definition. 


NOTE If you use cpp, C-style comments should only be used on separate lines. 
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This chapter consists of five programming examples in assembly 
language. The first three examples show typical assembly language code 
sequences; the last two examples show the correspondence between C, a 
higher-level programming language, and assembly language. 


Example 1 

Calculates the highest bit position set in a passed 
parameter. A binary search is used to enhance 
performance. 

Example 2 

Copies bytes from a source location to a destination 
location. Both locations and the number of bytes to 
copy are passed in as parameters. 

Example 3 

Uses Divide Step to divide a 64-bit signed dividend by a 
32-bit signed divisor. 

Example 4 

Uses a procedure call from a C program to the 
Assembler to verify that the program is passing the 
correct argument. 

Example 5 

Shows a C program that generates assembly code to 

call printf () . 
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1. Binary Search for Highest Bit Position 

The Shift Double and Extract Unsigned instructions are used to 
implement a binary search. Bits shifted into general register o are 
effectively discarded. 

.CODE 

.EXPORT post 

r 

; This procedure calculates the highest bit position 
; set in the word passed in as the first argument. 

; If passed parameter is non-zero, the algorithm 
; starts by assuming it is one. 

; A binary search for a set bit is then used 
; to enhance performance. 

r 

; The calculated bit position is returned to the caller. 

r 

.PROC 

post 

.CALLINFO SAVE_RP 

.ENTER 

COMB,=,N %r0,%argO,all_zeros ; No bits set 

LDI 31,%ret0 ; assume 2 to the 0 power 

t 

; if extracted bits non-zero, fall thru to change assumption 
; else set up 16 low order bits and keep assumption 

r 

EXTRU,<> %argO,15,16,%r0 ; check 16 high order bits 

SHD,TR %argO,%r0,16,%argO ; left shift argO 16 bits 

ADDI -16,%retO,%retO ; assume 2 to the 16 power 

r 

; if extracted bits non-zero, fall thru to change assumption 

; else set up 8 low order bits and keep assumption 

I 

EXTRU,<> %argO,7,8,%r0 ; check next 8 high order bits 

SHD,TR %argO,%r0,24,%argO ; left shift argO 8 bits 

ADDI -8,%retO,%retO ; assume 8 higher power of 2 

r 

; if extracted bits non-zero, fall thru to change assumption 

; else set up 4 low order bits and keep assumption 

r 

EXTRU,<> %argO,3,4,%r0 ; check next 4 high order bits 

SHD,TR %argO,%r0,28,%argO ; left shift argO 4 bits 

ADDI -4,%retO,%retO ; assume 4 higher power of 2 

r 

; if extracted bits non-zero, fall thru to change assumption 

; else set up 2 low order bits and keep assumption 

r 

EXTRU,<> %argO,1,2,%r0 ; check next 2 high order bits 

SHD,TR %argO,%r0,30,%argO ; left shift argO 2 bits 

ADDI -2,%ret0,%ret0 ; assume 2 higher power of 2 
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; if extracted bit is zero, fall thru and keep assumption 
; else make conclusion 


EXTRU,= %argO,0,1,%r0 

ADDI -1,%ret0,%ret0 

B,N tally 


check next bit 

next higher power of 2 


all_zeros 

LDI -1,%ret0 

tally 

.LEAVE 
.PROCEND 
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2. Copying a String 

This example contains a section of assembly code that moves a byte 
string of arbitrary length to an arbitrary byte address. 

; The routine reflect copies bytes from the source location 
; to the destination location. 

r 

; The first parameter is the source address and the second 
; parameter is the destination address. 

r 

; The third parameter is the number of bytes to copy. 

I 

; For performance, larger chunks of bytes are handled differently. 

r 

.CODE 

.EXPORT reflect,ENTRY 

reflect 

.PROC 


.CALLINFO 

ENT RY_GR= 6, SAVE_RP 


.ENTER 

COMB,=,N 

%arg2,%r0,fallout 

; done, count is zero 

COMB,<,N 

%arg2,%r0,choke 

; caller error, neg count 

OR 

%argO,%argl,%r6 

; source and dest 

OR 

%r6,%arg2,%r6 

; count 

EXTRU,= 

%r6,31,2,%r0 

; 2 low order bits = 0? 

B, N 

onebyte 

; yes, skip this branch 

ADDIBT,<,N 

-16,%arg2,chekchunk 

; no, skip chunkify if count<0 

chunkify 

LDWM 

16(%argO),%r6 

; word 1- > tempi 
; point ahead 4 words in source 

LDW 

-12(%argO),%r5 

; place mark 3 wds back- >temp2 

LDW 

-8(%argO),%r4 

; place mark 2 wds back- >temp3 

LDW 

-4(%argO),%r3 

; place mark 1 wds back- >temp4 

STW 

%r5,4(%argl) 

; dest wd 2 <-temp2 

STWM 

%r6,16(%argl) 

; dest wd 1 <-templ 
; point ahead 4 words in dest 

STW 

%r4,-8(%argl) 

; dest wd 3 <-temp3 

ADDIBF,< 

-16,%arg2,chunkify 

; loop if count > 0 

STW 

%r3,-4(%argl) 

; dest wd 2 <-templ 

chekchunk 

ADDIBT,< 

12,%arg2,exeunt 

; go if count < -12 

COPY 

%r0,%retO 

; clear rtnval 

subchunk 

LDWS,MA 

4(%argO),%r6 

; word- >templ 

; point ahead 4 bytes in source 

ADDIBF,< 

-4,%arg2,subchunk 

; go if count<4 

STWS,MA 

%r6,4(%argl) 

; dest< -tempi 

; point ahead 4 bytes in dest 
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B 

exeunt 

; all done 


COPY 

%r0,%retO 

; clear rtnval 


onebyte 

LDBS,MA 

1(%argO),%r6 

; tempi < -byte,bump src 

pointe 

onemore 

STBS,MA 

%r6,1(%argl) 

; dest<-templ,bump dest 

pointer 

ADDIBF,=,N 

-1,%arg2,onemore 

; decrement count 
; compare for 0. 


LDBS,MA 

1(%argO),%r6 

; delay slot 
; tempi <-byte,bump src 

pointer 

fallout 

B 

COPY 

exeunt 
%r0,%retO 



choke 

LDI 

14,%retO 




exeunt 

.LEAVE 
.PROCEND 
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start 


check_mag 


finish 


3. Dividing a Double-Word Dividend 

This example contains the code sequence to dividea 64-bit signed 
dividend by a 32-bit signed divisor using the ds (Divide Step) 
instruction. Table 7-1 on page 135 lists the registers that this program 
uses. 


MOVB,>= 

ADD 

SUB 

SUBB 


dvdu,rem,check_mag 

0,dvdl,quo 
0,quo,quo 
0,rem,rem 


; Move upper dividend 
; check for &< 0 
; Move lower dividend always 
; Get absolute value of 
; the dividend in rem,quo 


SUBT, = 


DS 

ADD 
DS, &« 

B, n 

ADDC 

DS 

t ••• 

;repeat divide 

f ... 

ADDC 

DS 

ADDC 

DS 

ADDC 

ADDB,>=,n 
ADD,& ^ 

ADD,tr 
ADDL 


0,dvr,tp 


0,tp,0; 

quo,quo,quo 
rem, dvr,rem 

min_ovf1 

quo,quo,quo 
rem,dvr,rem 

step sequence 

quo,quo,quo 
rem,dvr,rem 
quo,quo,quo 
rem,dvr,rem 
quo,quo,quo 
rem,0,finish 
dvr,0,0 
rem,dvr,rem 
rem,tp,rem 


; Check 0, clear carry, 

; negate the divisor 
; and trap if dvr = 0 
; Set V-bit to the complement 
; of the divisor sign 
; Shift msb bit into carry 
; 1st divide step, if carry 
; out msb of quotient = 0 
; Abs(quotient) > 2**31 
; deal with elsewhere 
; Shift quo with/into carry 
; 2nd divide step 


; Shift quo with/into carry 
; 31st divide step 
; Shift quo with/into carry 
; 32nd divide step, 

; Shift last quo bit into quo 
; Branch if pos. rem 
; If dvr > 0, add dvr 
; for correcting rem. 

; Else add absolute value dvr 


ADD,>= 
SUB 

XOR,>= 
SUB 


dvdu,0,0 
0, rem,rem 
dvdu,dvr,0 
0,quo,quo 


; Set sign of rem 
; to sign of dividend 
; Get correct sign of quo 
; based on operand signs 
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Table 7-1 


Register Designations 


Register 

Designations 

Purpose 

dvr 

Register holding divisor. 

dvdu dvdl 

Pair of registers holding dividend. 

tp 

Temporary register. 

quo 

Register holding quotient. 

rem 

Register holding remainder. 
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4. Demonstrating the Procedure Calling 
Convention 

AC program calls an assembly language program to test if .enter and 
. leave are worki ng correctly. The assembly I anguage program checks to 
see if the C program has passed the value zero in argO. The assembly 
language program then returns the value -9 in reto to the cal ling 
program. 

You need to compile this assembly listing using cc. The registers reto 
and argO aredeclared within /usr/iib/pcc_prefix. s, which is 
automatically included when you givethe C compiler an assembly file. 

To remove the dependency on pcc_prefix.s, replace all occurrences of 
reto with %r28 and argO with %r26. 

C Program Listing 

#include <stdio.h> 
int errorcount = 0; 
main () 

{ 

int toterr = 0; 

printf("TESTING FEATURE 000"); 
fflush(stdout); 

if ( feat000(000) != -9 ) ++errorcount; 

printf (" %d errorsWn" , errorcount) ; 

toterr += errorcount; 
errorcount = 0; 

} 
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Assembly Program Listing 

; Assembler Module that passes results back to C driver module 
myfeat .EQU 000 

success .EQU -9 

.CODE 

.IMPORT errorcount,DATA 
.SUBSPA $CODE$ 

.EXPORT featOOO,ENTRY 

.PROC 
.CALLINFO 
featOOO .ENTER 

LDI 0,retO 

COMIB,<> myfeat,argO,exit 

NOP 

LDI success,retO 

exit . LEAVE 

.PROCEND 

.END 
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5. Output of the cc -S Command 

This example shows how a simple C program generates assembly 
language code. The program calls theprintf () routine. To run the 
assembled code, you need to link the file /usr/ccs/lib/crto . o and 
theC library file. Remember that the id command requires that you link 
the crto. o filefirst in 32-bit mode only. You do not need to link 
/usr/ccs/lib/crtO.o in 64-bit mode.. 

C Program Listing 

main () 

{ 

printf ("Hello World\n")/ 

} 


Assembly Program Listing From the C 
Compiler 

.LEVEL 1.0 

.SPACE $TEXT$,SORT=8 

.SUBSPA $CODE$,QUAD=0,ALIGN=4,ACCESS = 4 4,CODE_ONLY,SORT=2 4 

main 

.PROC 

.CALLINFO CALLER,FRAME=0,SAVE_RP 
.ENTRY 

STW %r2,-20 (0,%r30) ;offset 0x0 

LDO 48 (%r30),%r30 ;offset 0x4 

ADDIL LR'$THIS_DATA$-$global$,%r27 ;offset 0x8 

.CALL ARGW0=GR ;in=26; 

BL printf,%r2 ;offset Oxc 

LDO RR'$THIS_DATA$-$global$(%rl),%r26 /offset 0x10 

L$exitl 

LDW -68 (0,%r30),%r2 /offset 0x14 

BV %r0(%r2) /offset 0x18 

.EXIT 

LDO -48 (%r30),%r30 /offset Oxlc 

.PROCEND / 


.SPACE $TEXT$ 

.SUBSPA $LIT$,QUAD=0,ALIGN—8,ACCESS—44,SORT = 16 
.SUBSPA $CODE$ 

.SPACE $PRIVATE$, SORT=16 

.SUBSPA $DATA$,QUAD=1,ALIGN=8,ACCESS=31,SORT=l6 
$THIS_DATA$ 

.ALIGN 4 

.STRINGZ "Hello World\n" 

.SUBSPA $SHORTDATA$,QUAD=1,ALIGN=8,ACCESS=31,SORT=24 
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$ THIS_SHORTDATA$ 

.SUBSPA $BSS$,QUAD=1,ALIGN=8,ACCESS=31,ZERO,SORT=82 
$THIS_BSS$ 

.SUBSPA $SHORTBSS$,QUAD=1,ALIGN=8,ACCESS=31,ZERO,SORT=80 
$THIS_SHORTBSS$ 

.SUBSPA $STATICDATA$,QUAD=1,ALIGN=8,ACCESS=31,SORT=l6 
$STATIC_DATA$ 

. SUBSPA $SHORTSTATICDATA$ , QUAD=1, ALIGN=8 , ACCESS=31, SORT=2 4 
$ SHORT_STATIC_DATA$ 

.IMPORT $global$,DATA 
.SPACE $TEXT$ 

.SUBSPA $CODE$ 

.EXPORT main,ENTRY,PRIV_LEV=3,RTNVAL=GR 

.IMPORT printf,CODE 

.END 
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Diagnostic Messages 


This appendix lists all error messages that originate from the PA-RI SC 
Assembler. 


The Assembler error messages aredivided into the foil owing categories: 


Warning Messages 
Error Messages 
Panic Messages 
User Warnings 

Limit Errors 

Branching Errors 


Conditions that cause errors in 
program execution. 

Conditions that cause the Assembler 
to terminate abnormally. 

Conditions that cause the Assembler 
to abort immediately. 

Conditions that cause the Assembler 
to produce an object file and possibly 
to take a specified corrective action. 

Conditions caused by running into 
Assembler limits or running out of 
memory. 

Conditions that prevent the 
Assembler from creating an object 
file. 


Message descriptions use symbols in the form &operand>to designate 
Assembler source elements that are the subject of the error. When a 
message is printed during the assembly operation, the & operand> 
symbol is replaced by the appropriate source element. 

The text for the Assembler messages is stored in a file with the path 
name: 


/usr/lib/nls/msg/$LANG/as.cat 

The default value for the localization environment variable lang is c. 
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Warning Messages 


The foil owing messages describe compiler warnings that prevent the 
Assembler from creating an object file. You must correct these errors to 
assemble your program. 


1 

MESSAGE 

Use of old style opcode, "%s" 


CAUSE 

Attempt to use an opcode that has 
been renamed for PA2.0. 


ACTION 

Consult the PA-RI SC Architecture 
manual for the new form of the 
opcode. 

2 

MESSAGE 

Unknown option "%s" ignored. 


CAUSE 

An unknown or invalid command-line 
option was passed to the assembler. 


ACTION 

Remove the invalid option from the 
command-line. 

3 

MESSAGE 

Argument is missing for "%s" 


CAUSE 

Missing argument for command-line 
option <operand>. 


ACTION 

Add an argument to the 
command-1 i ne opti on. 

4 

MESSAGE 

Illegal argument for option 
" % s " 


CAUSE 

Invalid value for command-line 
option <operand> 


ACTION 

Supply a valid value for the 
command-1 i ne opti on. 

5 

MESSAGE 

Usage of field selector "%s" 
with instruction "%s" may be 
incorrect 


CAUSE 

Using an improper field selector for 
the instruction. 


ACTION 

Change the field selector. 
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7 

MESSAGE 

Space characteristics may not 
be changed after first 
declaration 


CAUSE 

Attempt to change the val ues 
assigned to keywords for a space 
previously declared with a . space 
directive. The first declaration of the 
space may be in the file 

pcc_prefix.s. 


ACTION 

U se desi red val ues for keywords on 
first declaration of space. Specify 
keyword values on first declaration of 
space only. 

8 

MESSAGE 

Subspace characteristics may 
not be changed after first 
definition 


CAUSE 

Attempt to change the val ues 
assigned to keywords for a subspace 
previously declared with a 
. subspace directive. The first 
decl aration of the subspace may be i n 
the file pcc_pref ix. s. 


ACTION 

U se desi red val ues for keywords on 
first declaration of subspace. Specify 
keyword values on first declaration of 
subspace only. 

10 

MESSAGE 

Alignment omitted - 8 assumed 


CAUSE 

M issing argument for .align 
directive. 


ACTION 

U se a val id power of two i nteger 
argument with .align 

11 

MESSAGE 

Missing value - zero assumed 


CAUSE 

Missing argument for .origin or 
. equ directive 


ACTION 

Use a valid integer argument. 

12 

MESSAGE 

Size omitted - 4 assumed 
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13 


14 


15 


16 


CAUSE 

ACTION 

MESSAGE 

CAUSE 


ACTION 

MESSAGE 

CAUSE 

ACTION 

MESSAGE 

CAUSE 

ACTION 

MESSAGE 

CAUSE 


M issing argument for . comm 
directive. 

Specify the actual number of bytes to 
reserve. 

Modification of %r3 with a 
frame size 

larger than 8191 bytes 
violates .ENTER/.LEAVE 
convention 

General register 3 used as a 
temporary register within a 
procedure where the frame size was 
set by the frame keyword to a size 
larger than 8191 bytes. 

Note: %r3 is predefined as a frame 
pointer for procedures with large 
frames. 

Don't use %r3 as a temporary register 
in a procedure that has a large frame. 

KEEP should not be in force 
for this statement 

.keep directive used outside of a 
procedure 

Remove the .keep directive. 

Procedure makes calls but is 
not flagged as CALLER in 
CALLINFO 

Missing caller keyword in 
.CALLINFO directive for this 
procedure. 

Add caller keyword to . callinfo 

for this procedure. 

Redefinition of symbol 

Symbol used in label definition is 
already defined. 
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17 


18 


19 


20 


21 


ACTION 

MESSAGE 

CAUSE 

ACTION 

MESSAGE 

CAUSE 

ACTION 

MESSAGE 

CAUSE 

ACTION 

MESSAGE 

CAUSE 

ACTION 

MESSAGE 


Use a different name in the label part 
to avoid overwriti ng the previous 
definition. 

Existing register name, 
number, and type are being 
overwritten 

Name (label) used with .REGwas 
previously defined. 

Use a different name in the label part 
to avoid overwriting previous 
definition. 

The "%s" error message 
catalog cannot be located 

Error message catalog for lang 
operand> cannot be accessed. 

I nsurethat your nlspath variable is 
set correctly. Also insure that the 
default error message catalog for the 
assembler is accessible in 

/usr/lib/nls/msg/C/as.cat 

Defining register missing or 
defining register has no type 

Parameter to . reg is not one of the 
predefined assembler registers, nor is 
it a previously defined (by another 
.reg directive) register. 

Either use one of the predefined 
assembler register names or a 
register name previously defined by a 
.reg directive. 

General register expected in 
this field - %s 

Wrong register type used. 

Use a general register. 

Space register expected in 
this field - %s 
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CAUSE 

Wrong register type used. 


ACTION 

Use a space register. 

22 

MESSAGE 

Control register expected in 
this field - %s 


CAUSE 

Wrong register type used. 


ACTION 

Use a control register. 

23 

MESSAGE 

Floating point register 
expected in this field - %s 


CAUSE 

Wrong register type used. 


ACTION 

Use a floating-point register. 

25 

MESSAGE 

This subspace should have no 
initialized data in it 


CAUSE 

Use of a directive, such as .word that 
allocates and initializes data, when 
the currently active subspace has the 
zero keyword associated with it, 
which disallows initialized data. 


ACTION 

Either use the .block directive to 
allocate storage in this subspace or 
remove the zero keyword from the 
. subspace definition. 

26 

MESSAGE 

Output file name missing 


CAUSE 

Filename needed for -o 
command-1 i ne opti on. 


ACTION 

Supply a valid filename for the -o 
command-1 i ne opti on. 

27 

MESSAGE 

XREF file name missing after 

—v 


CAUSE 

Filename needed for -v 
command-1 i ne opti on. 


ACTION 

Supply a valid filename for the -v 
command-1 i ne opti on. 

28 

MESSAGE 

Only one copyright message 
permitted 
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29 


30 


31 


32 


33 


CAUSE 

ACTION 

MESSAGE 

CAUSE 

ACTION 

MESSAGE 

CAUSE 


ACTION 

MESSAGE 

CAUSE 

ACTION 

MESSAGE 

CAUSE 

ACTION 


More than one . copyright directive 
encountered. 

Remove the extra .copyright 
di recti ve(s). 

A procedure may not be empty 

Procedure with no code encountered. 

Add at least one instruction to 
procedure or delete the procedure 
from the source file. 

Procedure does not have 
.CALLINFO 

Procedure requires a .callinfo 
due to use of . enter/, leave or if 
there are no unwind space 
requirements. 

Insert a correct .callinfo directive 
at the start of the procedure. 

Empty source file(s) 

I n put sou rce fi I e was empty. 

An empty source file usually 
indicates an error of some kind. 

Missing .PROCEND 

A .proc was not terminated by a 
corresponding .procend 

Insert a .procend 


MESSAGE Cache hint may not work on 
some hardware 

CAUSE An instruction was encountered that 

was performing a load to %r0. This 
type of instruction is reserved as a 
hi nt to the cache system. H owever 
some of the early hardware didn't 
properly perform this cache hint 
feature. 
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ACTION 

Avoid using loads to %r0 if you want 
your code to execute correctly on all 
PA-RISC machines. 

34 

MESSAGE 

Missing .LEVEL directive; A .LEVEL 
1.0 was inserted before .ALLOW 


CAUSE 

A .allow directive was encountered 
without first seeing a . level 
directive. 


ACTION 

Insert a .level directive at the start 
of the source file. 

35 

MESSAGE 

Use of .ALLOW %s not 
meaningful for file assembled 
at .LEVEL %s 


CAUSE 

The .allow directive supplied has no 
meaning for a file assembled at given 
. level. For example if your source 
file specifies .level l . l then a 

.ALLOW 1.0 or. ALLOW 1 . 1 would 
not be meaningful for this source file. 


ACTION 

Removed .allow directive or change 

.LEVEL. 

36 

MESSAGE 

Use of %s is incorrect for 

the current %s of %s 


CAUSE 

Use of a feature that is not supported 
on the hardware that the assembler 
is targeting. The assembler is told 
what hardware it is targeting 
through the use of the . level and 
.allow directives. Using PA1.1 
features while at . level l . o will 
generate this message. 


ACTION 

Insert a .level or .allow directive 
as appropriate, or remove the 
offending instruction from the source 
file. 
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37 

MESSAGE 

Use of %s requires key bit %s 
to be enabled with a .LEVEL 

or .ALLOW 


CAUSE 

Use of a feature that requires a key 
bit to be set. 


ACTION 

Add key bit to the . level or . allow 
directive. 

38 

MESSAGE 

Encoding for %s requires a 
format that is incorrect for 

the current %s of %s 


CAUSE 

The instruction requires an encoding 
format that is not available on the 
hardware that the assembler is 
targeting. The assembler is told what 
hardware it is targeti ng through the 
use of the .level and .allow 
directives. Using a PA-RI SC 2.0 
instruction encoding format while at 
.level l . l will generate this 
message. 


ACTION 

Change the instruction such that it 
can be properly encoded on the 
hardware that the assembler is 
targeti ng or change the . level to 
2.0. 

39 

MESSAGE 

The completer specified , %s 
is obsolete but will be 
accepted as ,%s 


CAUSE 

The use of the , sh completer is 
incorrect. 


ACTION 

Replacethe, sh completer by the, bc 
completer is the source. 

40 

MESSAGE 

Poorly formed operand, 
accepted as %s(%rO) 


CAUSE 

The previous assembler would 
silently accept poorly formed 
operands and add a trailing (%rd) to 
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the operand. The new assembler will 
also accept these poorly formed 
operands and also add the trailing 
(%r0) to the operand, but it 
additionally flags this as a potential 
problem by issuing this warning. 

ACTION Add a trailing (%r0) totheoperand or 

otherwise correct the poorly formed 
operand. 

41 MESSAGE A register typed operand is 

expected here - %s 

CAUSE The old assembler would accept 

integers between 0 and 31 as valid 
registers, or alternatively accept 
names that were defined using a 
. equ to an i nteger. The new 
assembler performs additional type 
checks on the operands and wants to 
see either a predefined register 
(starting with a %) or a register name 
that was previously defined by the 
.reg directive. The file 

/usr/lib/pcc_prefix.s is 

typically included when the 
assembler is invoked through cc (l) 
and this file defines many register 
names that are typically used in 
assembly programs. 

ACTION Inspectthesourcefileand replacethe 

integer with the appropriate 
predefined register, or for a name, 
find and replacethe .equ directive 
with a correct .reg directive. 

Alternatively the w4i command-line 
opti on may be used to suppress al I 
occurrences of this warning message. 

Note that future versions of the 
assembler may require proper 
register typing of operands in order 
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42 


44 


MESSAGE 

CAUSE 


ACTION 


MESSAGE 

CAUSE 


ACTION 


for it to be able to disambiguate 
between i mmedi ates and registers for 
certain opcodes. Thus in future 
versions of the assembler this 
message may be a non-suppressible 
error instead of a warning. 

Use of %s is incorrect for 
the current %s of %s 

Use of a cbit in a FTEST or FCMP 
instruction, with a . level of 1.1 or 
1.0. The cbit feature of FCMP and 
FTEST is only available for .level 
2 . 0 . 

Insert a .level or .allow directive 
as appropriate, or remove the 
offending instruction from the source 
file. 

Value for ACCESS was not 
specified for this new 
.SUBSPA directive. 

A new subspace is being defined by 
the this . subspa directive and a 
value of the access keyword is not 
supplied. You must always give a 
value for access when defining a 
new subspace. 

If the subspace that you are 
referencing is a predefined subspace 
then make sure that the header file 
/usr/lib/pcc_pref ix . s is being 
included. You must add the header 
file to the command-line if you are 
invoking as (l) directly. The header 
file will typically be included for you 
if you invoke the assembler using 
cc (1) 

If you are declaring a new subspace 
then add the proper access 
definition to the . subspa directive. 
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45 


46 


47 


MESSAGE 

CAUSE 

ACTION 

MESSAGE 

CAUSE 


ACTION 

MESSAGE 

CAUSE 

ACTION 


The value access=0x2c should be 
used for all code or read-only 
subspaces and the val ue 
ACCESS=Oxif should be used for all 
data or read-write subspaces. 

Previous value for .SHLIB is 
being changed to this value 

More than one .shlib directive was 
encountered. 

Remove the extra .shlib 
di recti ve(s). 

The +DA option conflicts with 
the .LEVEL directive, using 
.LEVEL %s. 

The assembly source file contained a 
.level directive which conflicted 
with the command-line +da option. 
The assembler always honors the 
.level directive found in the source 
file. The command-1 ine+DA was 
ignored. 

Remove +da from the command-1 i ne 
used to invoke the assembler. 

The behavior of instruction 
%s is undefined with the 
operands and completers 
supplied. 

The behavior of the instruction used 
is undefined with the operands 
supplied. 

Read the PA-RI SC Architecture 
manual entry for the instruction 
being used, paying attention to the 
cases in which the behavior of the 
instruction is undefined. Recodethe 
operands for the instruction so that 
the operands don't cause the 
instruction to be undefined. 
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48 


49 


MESSAGE 

CAUSE 

ACTION 

MESSAGE 

CAUSE 

ACTION 


Expression encountered while 
expecting a register; 

Register %s substituted for 
expression. 

An expression was encountered in a 
location where a predefined register 
(starting with a % or a register name 
that was previously defined by the 
.reg directive was expected. (Also 
see warning 41). 

Replace expression with a predefined 
register or a register name that was 
previously defined by the .reg 
directive. 

Number is too large. The 
value -1 will be used 
instead. 

A number was encountered that was 
too I arge to fit i n a 64-bit i nteger. 

Replace the number with a smaller 
value. 
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Error Messages 


The foil owing messages describe compilation errors that prevent the 
Assembler from creating an object file. You must correct these errors to 
assemble your program. 

1000 

MESSAGE 

Unterminated quoted string 


CAUSE 

String specified was missing the 
trailing double quote. Strings literals 
can not span multiple lines. 


ACTION 

Add trai 1 i ng dou ble quote to stri ng. 

1001 

MESSAGE 

Undefined register symbol 


CAUSE 

Name specified is not a predefined or 
.reg defined register symbol 


ACTION 

Correct spelling of name or add .reg 
directive to define name. 

1002 

MESSAGE 

Undefined completer 


CAUSE 

1 nvalid value used in completer field. 


ACTION 

Use a proper completer as specified in 
PA-RISC Architecture and 

1 nstruction Set Reference Manual. 

1003 

MESSAGE 

Improper completer ,%s 
specified for opcode %s 


CAUSE 

The completer used is not a valid 
completer for the instruction. 


ACTION 

Consult the PA-RI SC Architecture 
and 1 nstruction Set RderenceManual 
for the 1 ist of val id completers for this 
instruction. 

1004 

MESSAGE 

Illegal completer combination 
specified for opcode %s 


CAUSE 

The combination of completers used 
is not valid for the instruction. 


154 


Chapter 8 




Diagnostic Messages 

Error Messages 


1005 


1007 


1008 


1009 


1010 


ACTION 


MESSAGE 

CAUSE 

ACTION 

MESSAGE 

CAUSE 

ACTION 


MESSAGE 

CAUSE 

ACTION 


MESSAGE 

CAUSE 

ACTION 

MESSAGE 

CAUSE 


Consult the PA-RI SC Architecture 
and I nstruction Set R Terence 
Manual, for the list of valid completer 
combinations for this instruction. 

Unable to open xref file: %s 

Assembler could not create or access 
the file specified with the -v 
command-1 i ne opti on. 

Insure that the directory is writable. 

Label not allowed here in 
this expr 

Assembler will not allow a label here. 

Expressions must be in the form 
label l[[-label2]+constant_exp] 
Reorder expression to be in the 
proper form. 

Illegal symbol in expression 

An expression contains a sequence 
other than I abel operator term or term 
operator term 

PI ace operators +, -, between a label 
and a term, or place operators +, -, *, 
/ between a term and term. Note that 
a term means a constant expression. 

Field selector not allowed in 
pc-relative expression 

Field selector, such as l 1 or r' used on 
a expression that is a branch target. 

Omit field selectors from branch 
target expression. 

String not allowed in 
pc_relative expression 

String used for branch target 
expression. 


Chapter 8 


155 




Diagnostic Messages 

Error Messages 


1011 


1012 


1013 


1014 


1015 


ACTION 

MESSAGE 

CAUSE 

ACTION 

MESSAGE 

CAUSE 

ACTION 

MESSAGE 

CAUSE 

ACTION 

MESSAGE 

CAUSE 

ACTION 

MESSAGE 

CAUSE 

ACTION 


Replace with an expression beginning 
with a label or 

"." allowed in pc_rel 
expression only 

A period (.) used as an operand in a 
non-branch context, or used as a 
target in external branch or vectored 
branch. 

Use only for pc-relative branches, 
not in branch external or branch 
vectored. 

PC-relative expression must 
begin with . or label 

Branch target is poorly formed. 

Use a label or "."as the first term of a 
branch expression 

Second label not allowed in 
pc_relative expression 

Branch target is poorly formed: label 
operator label 

U se an offset i n pi ace of the second 
label. 

Labels may not be added, they 
may only be subtracted 

Attempt to form the sum of two 
labels. 

U se an offset i n pi ace of the second 
label. 

Unexpected end of expression 

Nothing follows a +, -, /, or * in an 
expression. 

Place meaningful terms, integers or 
labels after operator. 
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1016 

MESSAGE 

General register %s is out of 
range 


CAUSE 

Register number specified greater 
than 31 or less than 0. 


ACTION 

Use a valid general register number 
between 0 and 31. 

1017 

MESSAGE 

Value of %s for space 
register not in %sr0..%sr3 


CAUSE 

Space register specified was not in 
the legal range. 


ACTION 

Use a space register in the valid 
range 0 to 3. 

1018 

MESSAGE 

Value of %s for space 
register not in %sr0..%sr7 


CAUSE 

Space register number specified 
greater than 7 or less than 0 


ACTION 

Use a valid space register number 
between 0 and 7. 

1019 

MESSAGE 

Opcode %s not defined 


CAUSE 

Characters in the opcode field do not 
comprise a legal machine instruction 
or directive. 


ACTION 

Starting in column 2, use only valid 
opcodes and directives as specified in 
PA-RISC Architecture and 

Instruction Set Reference Manual. 

1020 

MESSAGE 

Number required for keyword 
value 


CAUSE 

A .callinfo keyword was assigned 
a non-numeric argument. 


ACTION 

Ensure that .callinfo keywords 
are assigned numeric or register 
values. 

1021 

MESSAGE 

Unrecognized value for 
keyword 
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1022 


1023 


1024 


1025 


1026 


CAUSE 

ACTION 

MESSAGE 

CAUSE 

ACTION 

MESSAGE 

CAUSE 

ACTION 

MESSAGE 

CAUSE 

ACTION 

MESSAGE 

CAUSE 

ACTION 

MESSAGE 


11 legal assignment for argw or 
rtnval keyword i n . call or 
.export directive 

Use no, gr, fr, or fu as appropriate. 

This directive must occur 
within a declared 
subspace: .%s 

The directive used must appear 
inside of a . subspa. The directive 
was place outside of a subspace. 

Insert a . subspa before issuing this 
directive. 

Directive .%s not allowed 
inside a procedure 

Use of this directive must occur 
outside of a .PROcThe .locct, 

. space or . subspa directives must 
occur outside of a . proc 

Do not attempt to change the I ocati on 
counter, space or subspace within a 
procedure. 

Space name required 

. space directive is not followed by a 
valid name. 

Follow .space directive with a valid 
name. 

Unrecognized keyword 

Directive, such as .space, .subspa, 
or . callinfo followed by a keyword 
not specified in the Assembler 
manual. 

Follow directives with legal keywords 
separated by commas. 

Identifier %s previously 
defined 
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1027 


1028 


1029 


1030 


CAUSE 

ACTION 

MESSAGE 

CAUSE 

ACTION 

MESSAGE 

CAUSE 

ACTION 

MESSAGE 

CAUSE 

ACTION 

MESSAGE 

CAUSE 


The name bei ng defined al ready has a 
definition. Each identifier can only 
have one legal meaning. You can't 
define both a space and a subspace 
with the same name. 

Change the name used by one of the 
definitions to a unique name. 

This item must be declared 
within a space 

A directive such as . subspa, is used 
before the first .space directive. 

Insert a valid .space directive prior 
to the offending directive. 

Subspace name required 

. subspa directive is not followed by 
a valid name. 

Follow . subsp directive with a valid 
name. 

Directive .%s must occur 
within a procedure 

Directive such as .callinfo, 

. enter or . leave is used outside of 
a procedure. A procedure is defined 
by a matchi ng pai r of . proc, 
.procend directives. 

Move the offending directive inside a 
procedure or correct the location of 
the .proc and .procend directives 
for this procedure. 

Only one .CALLINFO per 
procedure 

Multiple .callinfo directives were 
found within a procedure. A 
procedure is defined by a matching 
pair of .proc, .procend directives. 
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1031 


1032 


1033 


1034 


ACTION 

MESSAGE 

CAUSE 

ACTION 

MESSAGE 

CAUSE 

ACTION 

MESSAGE 

CAUSE 

ACTION 

MESSAGE 

CAUSE 


Remove the duplicate .callinfo 
directive or correct the location of the 
.PROC and .procend directives for 
this procedure. 

Value for %s must be >=0 

1. In a .callinfo directive the 
parameter frame is assigned a 
negative value. 2.1 n .block or 
. blockz directive the parameter is a 
negative value. 

Supply a non-negative value. 

Value for %s must be in range 
%r3..%rl8 


In a .callinfo directive the 
parameter entry_gr is assigned an 
invalid general register. 

Use a general register in the range 
%r3 to %ri 8 when assigning to the 
parameter entry_gr. 

Value for %s must be in range 
%frl2..%fr21 

In a .callinfo directive the 
parameter entry_fr is assigned an 
invalid floating-point register. 

Use a floating-point register in the 
range %fri2 to %fr2i when 
assigning to the parameter 

ENTRY_FR. 

ENTRY_SR must be %sr3 or not 
specified 

In a .callinfo directive the 
parameter entry_sr specifies an 
invalid space register. 
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1035 


1036 


1037 


1038 


ACTION 

MESSAGE 

CAUSE 

ACTION 

MESSAGE 

CAUSE 


ACTION 

MESSAGE 

CAUSE 

ACTION 

MESSAGE 

CAUSE 

ACTION 


Only %sr3 is saved using the 
PA-RISC calling convention. Either 
specify %sr3 or omit the entry_sr 
keyword. 

Instructions must occur 
within a declared subspace: 

%s 

I nstructions present before . subspa 
directive 

Use . subspa directive before issuing 
instructions 

Illegal use of %previous_sp, 
must be used as a base 
register 

The pseudo register %previous_sp 
is being used in an instruction as a 
source or destination register. This 
special register can only be used as a 
base register. 

Use %previous_sp as the base 
register in a Load or Store 
instruction. 

nested .PROC 

A second .proc directive was 
encountered before a .procend 
directive 

I nsert . procend directive before the 
second .proc directive, or remove 
unnecessary .proc directive. 

Label name required for %s 

Directive, such as .comm, .reg, .equ 
or .macro requires that a label be 
present. 

Add a label starting in column 1 to 
use as the name being defined by this 
directive. 
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1039 


1041 


1044 


1045 


1046 


1047 


MESSAGE 

CAUSE 

ACTION 

MESSAGE 

CAUSE 

ACTION 

MESSAGE 

CAUSE 

ACTION 

MESSAGE 

CAUSE 

ACTION 

MESSAGE 

CAUSE 

ACTION 

MESSAGE 


Missing string constant 

Directive, such as .string, 

.STRINGZ, .VERSION, Or 

.copyright is present without a 
string operand. 

Add missing quoted string after 
directive. 

Name required for %s 

Directive, such as . import, 

.export, .space or . subspa is not 

followed by an valid identifier. 

Follow directive with a legal 
identifier. 

Name required for label 
definition 

. label directive is not followed by a 
legal identifier 

Add missing identifier after .label 
directive. 

Name to be defined by .LABEL 
must appear as operand. 

The .label directive cannot have an 
identifier in column one. 

Place identifier after .label 
directive, not before it. 

Duplicate definition of 
symbol 

The same identifier appeared more 
than once in column one, or was 
defined more than onetime with a 
. label directive. 

Rename one of the labels. 

Unmatched .PROCEND 


162 


Chapter 8 




Diagnostic Messages 

Error Messages 


1048 


1050 


1051 


1052 


1053 


CAUSE 

ACTION 

MESSAGE 

CAUSE 

ACTION 

MESSAGE 

CAUSE 

ACTION 

MESSAGE 

CAUSE 

ACTION 

MESSAGE 

CAUSE 

ACTION 

MESSAGE 


Two .procend directives were 
encountered without a .proc 
directive in between. 

Each procedure should begin with a 
single . proc and end with a single 

.PROCEND. 

Comma expected 

A directive which expects two or more 
operands was missing a comma 
between it's operands. 

I nsert comma between operands. 

Illegal symbol in label 
position 

Illegal character present in identifier 
which begins in column one. 

Use only legal identifiers in label 
field. 

Illegal symbol in opcode 
position 

A sequence of characters starti ng i n 
column two or beyond does not begin 
with a alphabetic character or period. 

Use only valid opcodes and directives 
starting in column two or beyond. 

Directive name not recognized 

A sequence of characters starti ng i n 
column two or beyond, beginning 
with a period, does not correspond to 
a legal directive. 

Check spelling of directive. Use only 
legal directive names starting in 
column two or beyond. 

Displacement must be a 
constant expression 
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1054 


1055 


1056 


1057 


CAUSE 

ACTION 

MESSAGE 

CAUSE 

ACTION 

MESSAGE 

CAUSE 

ACTION 

MESSAGE 

CAUSE 

ACTION 

MESSAGE 

CAUSE 

ACTION 


The displacement for this instruction 
must be a constant expression. 

Rewritetheinstruction sothat it uses 
a constant expression. 

Unexpected items at end of 
line 

Legal operands are foil owed by 
trailing characters or operators. 

E xami ne enti re sequence of 
operations for syntactic integrity. 
Possibly insert a to denote a 
comment after legal operands. 

Label must be defined within 
a declared subspace 

Label is present before a .subspa 
directive. 

Place label after issuing .subspa 
directive. 

Poorly formed .DWORD argument 

The syntax for this .DWORD 
argument is invalid. 

Consult the Assembler manual for 
the valid syntax. 

Unexpected register symbol %s 
found in a constant 
expression 

A predefined register or a name 
defined by a .reg directive was 
encountered in a location where only 
an integer constant, a name defined 
by a . equ directive, may occur. 

Replace the predefined register or a 
name defined by a .reg directive by a 
constant, or change the .reg 
directive into a .equ directive. 
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1059 


1060 


1061 


1062 


1063 


1064 


MESSAGE 

CAUSE 

ACTION 

MESSAGE 

CAUSE 

ACTION 

MESSAGE 

CAUSE 

ACTION 

MESSAGE 

CAUSE 


ACTION 

MESSAGE 

CAUSE 

ACTION 

MESSAGE 

CAUSE 

ACTION 


Divide by zero 

Attempt to perform division with a 
zero divisor. 

Examine definition of divisor, ensure 
that it is not zero. 

Argument 0 or 2 in FARG upper 

Using the fu value with argwo or 
argw2 keywords. 

Only use the fu value with argwo or 
argw2 keywords. 

Closing parenthesis is 
missing in expression 

Mismatched parenthesis. 

I nsert closing parenthesis in the 
expression. 

Macro parameters must be 
separated by commas 

Formal parameters to .macro or 
actual parameters to a macro 
invocation are not separated by 
commas. 

I nsert commas between parameters. 

Unterminated macro definition 

A .macro directive is not matched 
with a .endm directive. 

Terminate macro definition with 

.ENDM. 

Poorly formed macro parameter 

Formal parameter to the macro 
definition is not in the format 
accepted by the Assembler. 

Change the form of the formal 
parameter to an acceptable form. 
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1065 


1066 


1067 


1068 


1069 


MESSAGE 

CAUSE 

ACTION 

MESSAGE 

CAUSE 

ACTION 

MESSAGE 

CAUSE 

ACTION 

MESSAGE 

CAUSE 


ACTION 

MESSAGE 


Poorly formed .FLOAT or 
.DOUBLE argument 

The floating-point number that was 
used as the argument to . float or 
. double is not i n the right format. 

Use a properly formatted 
floating-point constant for the 
argument. 

Poorly formed bit field 
specifier 

Bit field is not specified in the form 
jx..y}where x and y are non-negative 
i ntegers. 

Specify bit fields in the correct 
format. 

Bit field too wide for 
instruction field 

Mismatched bit field declaration and 
usage. 

Use the same length bit field for the 
bit field bei ng assigned to and the bit 
field being assigned from. 

Brace outside of macro 
definition 

Opening brace (-0 or closing brace (}) 
used outside a macro definition. 
These symbols can only be used with 
a macro definition. They are used to 
form a bit field within a macro 
definition. 

Remove opening or closing brace and 
ensure that they are only used within 
a macro definition. 

Equal sign required in bit 
field assignment 
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CAUSE 

Missing assignment operator = for 
assigning one bit field to another. 


ACTION 

1 nsert assignment operator = for bit 
field assignment. 

1070 

MESSAGE 

Bit range must be within 
{0. .31} 


CAUSE 

Range specified in bit field is not in 
the legal range. 


ACTION 

Ensure bit field range is within the 
range 0 to 31. 

1071 

MESSAGE 

Opening brace expected in bit 
range designator 


CAUSE 

Missing opening brace to specify bit 
field 


ACTION 

Use correct format for bit field 
specification. 

1072 

MESSAGE 

Ending brace expected in bit 
range designator 


CAUSE 

Missing closing brace to specify bit 
field 


ACTION 

Use correct format for bit field 
specification. 

1073 

MESSAGE 

Unmatched .ENDM 


CAUSE 

No .macro directive was recognized 
as correspondi ng to the . endm 
directive. 


ACTION 

Either remove the unmatched .endm 
directive or insert a .macro directive 
in an appropriate position preceding 
the .endm directive. 

1074 

MESSAGE 

Illegal expression type for 
plabel 


CAUSE 

More than one label was found in a 
plabel expression. 
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1075 


1076 


1077 


1078 


1079 


ACTION 

MESSAGE 

CAUSE 

ACTION 

MESSAGE 

CAUSE 

ACTION 

MESSAGE 

CAUSE 

ACTION 

MESSAGE 

CAUSE 

ACTION 

MESSAGE 

CAUSE 


Use only one label in a plabel 
expression. 

Undefined field selector 

Illegal field selector is being used. 

Use correct field selector. 

Recursive macro expansion for 
%s 

Recursive macro expansion not 
permitted. 

Change macro definition to not be 
recursive. 

A .CALLINFO may specify 
either CALLS or N0_CALLS but 
not both 

A . callinfo directive contained 
both the calls and no_calls 

operands. 

Remove either calls or no_calls 
from the .callinfo directive. 

Only one architecture 
revision level can be 
specified with .LEVEL 

More than one . level directive was 
encountered and they specified 
different architecture levels. 

Remove the inappropriate .level 
directive. 

Missing "=" for parameter %s 

An operand to a directive is expecting 
a value to be supplied. For example, 
the frame keyword to the 
.callinfo directive expects an 
argument to be associated like this: 
FRAME=32 
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1080 


1081 


1082 


ACTION 

MESSAGE 

CAUSE 


ACTION 

MESSAGE 

CAUSE 


ACTION 

MESSAGE 

CAUSE 


ACTION 


Supply the missing value to be 
associated with the keyword using 
the format keyword =value 

Missing integer for parameter 
%s 

An operand to a directive is expecting 
a value to be supplied. For example, 
the frame keyword to the 
.callinfo directive expects an 
argument to be associated like this: 
FRAME=32 

Supply the missing value to be 
associated with the keyword using 
the format keyword=integer. 

Missing register for 
parameter %s 

An operand to a directive is expecting 
a value to be supplied. For example 
the entry_gr keyword to the 
.callinfo directive expects an 
argument to be associated like this: 
ENTRY_GR=%r6 

Supply the missing value to be 
associated with the keyword using 
the format keyword=register. 

Wrong kind of register for 
parameter %s 

An operand to a directive is expecting 
a different register class to be 
supplied. For example the entry_gr 
keyword to the .callinfo directive 
expects a general purpose register to 
be associated; supplying a 
floating-point register to entry_gr 
would produce this error message. 

Use a register of the expected class 
for the keyword. 
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1083 


1084 


1085 


1086 


1087 


MESSAGE 

CAUSE 

ACTION 

MESSAGE 

CAUSE 

ACTION 

MESSAGE 

CAUSE 

ACTION 

MESSAGE 

CAUSE 

ACTION 

MESSAGE 

CAUSE 


Floating point register %s is 
out of range 

The val ue suppl i ed does not 
correspond to a legal floating-point 
register number. 

Supply a valid floating-point register 
number. 

Control register %s is out of 
range 

The value supplied does not 
correspond to a legal control register 
number. 

Supply a valid control register 
number. 

Illegal value for alignment 

The value supplied for alignment is 
not a valid alignment value. Valid 
values are powers of 2 that are 
greater than zero and less than or 
equal to 4096. 

Change alignment value to a legal 
value. 

Only one type can be 
specified for a symbol with 
.EXPORT 

More than one symbol type was given 
for the .export directive. 

Remove the extra type from the 
. export directive. 

Bad value for .SHLIB 
parameter, format is 
"mm/yyyy" 

The parameter to the . shlib 
directive was not in the proper 
format. The format must be 
mm/ yyyy, when mm is the integer 
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value for the month, 

(J an=l,...Dec=12) and yyyy is the 
year. 


ACTION 

Changethe parameter to . shlib to a 
valid value. 

1088 

MESSAGE 

Floating point register %s is 
out of range for %s,SGL 


CAUSE 

The floating-point register used is not 
valid for this opcode. The multiops 
FMPYADD,SGL and FMPYSUB,SGL 
require that the operands be single 
precision floating-point registers in 
the range %fri6L, %fri6R .. 

%fr3iL, %fr3iR. Specifying a 
register below %fri6 will result in 
this error message. 


ACTION 

You must use single precision 
floating-point registers in the range 

%frl6L,%frl6R .. 

%fr3iL, %fr3iR when using single 
precision fmpyadd or fmpysub. 

1089 

MESSAGE 

Revision level must be 
specified for .LEVEL 
directive 


CAUSE 

A . level directive was missing an 
architecture level value. 


ACTION 

You must specify a valid architecture 
level of 1.0, 1.1, or 2.0. 

1090 

MESSAGE 

Value of %ls must be in the 

range 

[%2s..%3s] 


CAUSE 

The immediate value %ls is 
constrained to be in the range 
%2s..%3sfor the current instruction. 


ACTION 

Use a different instruction that 
allows for a larger range, or use a 
register to hold the value %ls. 
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1091 


1094 


1095 


1096 


MESSAGE 

CAUSE 

ACTION 

MESSAGE 

CAUSE 

ACTION 

MESSAGE 

CAUSE 

ACTION 

MESSAGE 

CAUSE 


ACTION 


Incorrect register %s used 
with %s optional target 
register must be %s. 

This opcode takes an optional 
register operand as specified. The 
register you used for this operand 
was incorrect. 

Use either the correct operand or no 
operand. 

Value for %s must be in range 

0. .3 

The value supplied for the privilege 
level was outside the legal range of 0 
to 3. 

Supply a valid value in the range 0 to 
3 for the privilege level. 

Not enough operands for 
instruction %s 

While parsing the operands for the 
current instruction <inst>, the 
assembler encountered the end of the 
line whileit was still expecting one or 
more operands for the instruction. 

Supply the missing operand(s). 

Missing completer for opcode 
%s 

The instruction <inst> requires a 
completer. For example the 
instruction bb always requires a 
completer (either < or >=); omitting 
this completer will cause the 
assembler to generate this error 
message. 

Inspect the current instruction for 
missing completers and add the 
appropri ate compl eter. 
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1097 


1098 


1099 


1100 


MESSAGE 

CAUSE 

ACTION 

MESSAGE 

CAUSE 

ACTION 

MESSAGE 

CAUSE 

ACTION 

MESSAGE 

CAUSE 

ACTION 


A "(" was expected while 
parsing the operands 
of instruction %s 

The operands for the current 
instruction do not have a "(" in the 
correct location. 

Inspect the current instruction and 
change the operands to the 
instruction so that the are valid. 

A ")" was expected while 
parsing the operands 
of instruction %s 

The operands for the current 
instruction do not have a ")" in the 
correct location. 

Inspect the current instruction and 
change the operands to the 
instruction so that the are valid. 

A register was expected while 
parsing the operands of 
instruction %s 

The operands for the current 
instruction do not have a register in 
the correct location. 

Inspect the current instruction and 
change the operands to the 
instruction so that the are valid. 

A was expected while 

parsing the operands 
of instruction %s 

The operands for the current 
instruction do not have a comma (,) in 
the correct location. 

Inspect the current instruction and 
change the operands to the 
instruction so that the are valid. 
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1101 


1102 


1103 


1104 


MESSAGE 

CAUSE 


ACTION 

MESSAGE 

CAUSE 

ACTION 

MESSAGE 

CAUSE 

ACTION 

MESSAGE 

CAUSE 


Standard input must be a pipe 
or FIFO, not a TTY or device 
f ile. 

The assembler was invoked without 
any input files on the command-line. 
For this situation the assembler will 
then attempt to use the standard 
i nput of a U NIX pi pe command. The 
object file will be written to standard 
output for this case. However, before 
assembling the standard input, the 
assembler will attempt to discover if 
the standard input file is associated 
with a TTY or termi nal. I f the 
assembler determines that standard 
input is associated with a TTY or 
terminal then it prints this error 
message and exits. 

Supply a filename when invoking the 
assembler, or use a U NIX pi pe to 
provide an input file for the 
assembler. 

Displacement of %s must be 
multiple of four 

The displacement in this instruction 
must be a multiple of four. 

Use a displacement that is a multiple 
of four. 

Displacement of %s must be 
zero with ,0 

The displacement must be zero when 
using the , o completer. 

Use a displacement of zero. 

Displacement can't be zero 
with ,MA 

The displacement cannot be zero 
when using the , ma completer. 
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1105 


ACTION 

MESSAGE 

CAUSE 

ACTION 


Use a non-zero displacement. 

Displacement of %s must be 
multiple of eight 

The displacement in this instruction 
must be a multiple of eight. 

Use a displacement that is a multiple 
of eight. 
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Panic Messages 


The following messages describe panic errors that cause the Assembler 
toterminate immediately and prevent it from creating an object file. You 
must correct these errors to assemble your program. 


2000 

MESSAGE 

Exceeded maximum error count 


CAUSE 

More than 100 errors were detected 
and the -e option was not used. 


ACTION 

Use the -e option to permit up to a 
million errors. 

2002 

MESSAGE 

Unable to open input file: %s 


CAUSE 

The input file is either nonexistent or 
unreadable. 


ACTION 

Check for presence of requested input 
file and examine the read permission 
for the file. 

2003 

MESSAGE 

Unable to open output file: 

%s 


CAUSE 

One of the foil owing: 1. Output file 
exists and is not writable. 2. 

Directory is not writable 3. File 
system is not writable. 4. Filesystem 
full 5. Filesystem error. 


ACTION 

Perform the corresponding action: 1. 
Delete output file or make output file 
writable. 2. Makedirectory writable. 
3. Usea read/write file system for the 
output file. 4. Contact your H P-UX 
system administrator 5. Contact your 
FI P-UX system administrator 

2004 

MESSAGE 

Free storage exhausted 


CAUSE 

Assembler cannot allocate memory 
for it's internal structures. 
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2005 


2006 


2007 


2008 


ACTION 

MESSAGE 

CAUSE 

ACTION 

MESSAGE 

CAUSE 

ACTION 

MESSAGE 

CAUSE 

ACTION 

MESSAGE 

CAUSE 

ACTION 


Break up the program into smaller 
modules. If this does not work contact 
your HP-UX system administrator. 

Internal instruction parsing 
error on %s 

Assembler has an internal defect. 

H ave your HP-UX system 
administrator contact HP Technical 
Support. 

Unable to regain access to 
source file for listing 

Not ableto access source file for 
reading, while formatting the 
assembly listing file. 

Check for existence of source file and 
permission to read it. 

Unable to access temporary 
file to build listing 

Not ableto write to the temporary 
listing file. Could be a filesystem 
error. 

Contact your H P-UX system 
administrator. 

Unterminated macro definition 

Macro definition is not complete until 
a . endm is encountered. 

I nsert a . endm at the end of the 
macro definition. 
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User Warning Messages 


The following messages are user warnings. The Assembler will proceed, 
and produce an object file, in some cases taking the corrective action 
described. 


7000 


7001 


7002 


MESSAGE 

CAUSE 

ACTION 


MESSAGE 

CAUSE 

ACTION 

MESSAGE 

CAUSE 


Model number is unknown; will 
default to arch-rev code 
generation. 

The model number given on a +DA 
option is not known to the compiler. 

The default codegeneration is as 
specified in the warning. If this is not 
the desired target architecture 
revision, specify the version using an 
architecture revision (e.g., 1.1) 
instead of a model number on the 
+DA option. 

Architecture version is 
unknown; will default to 
arch-r©/ code generation. 

The architecture revision given on a 
+da option is not known to the 
compiler. 

The default code generation is as 
specified in the warning. If this is not 
what is desired, an alternate 
architecture revision may be 
specified. 

Cannot open sched.models. 
( 7002 ) 

Thefile sched. models does not exist 
or cannot be opened for reading. 
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7003 


7004 


7005 


7006 


ACTION 

MESSAGE 

CAUSE 

ACTION 


MESSAGE 

CAUSE 

ACTION 

MESSAGE 

CAUSE 

ACTION 

MESSAGE 


Check protections on 

/opt/langtools/lib/sched.models 
and /usr/lib/sched.models. If 

neither file exists, contact your HP 
Service Representative. 

Improper argument to +DA 
option. (7003) 

An improper argument was given to 
the +da or +ds option. 

The +DAmodel is either a model 
number (such as 877 or 150, or one of 
the PA-RI SC architecture 
designations 1.0 or 1.1. The 
+Dsmodel is either a model number 
(such as 877 or 150), or one of the 
PA-RI SC processor names (such as 
PA7100). Seethe 

/opt/langtools/lib/sched.models 

file for model numbers, 
architectures, and processor names. 

Debug information may be 
corrupt: %ls unresolvable 
reference %2s (7004) 

Internal compiler error. 

Report error to your H P Service 
Representative. 

Unrecognized opcode %ls 
(7005) 

The opcode specified i n an i nl i ne 
assembly call was invalid. 

Check the architecture instruction 
set specification to determine valid 
opcode names. 

Improper completer ,%ls given 
for opcode %2s (7006) 
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CAUSE 

The completer specified in an inline 
assembly call was invalid for the 
opcode given. 


ACTION 

Check the architecture instruction 
set specification to determine valid 
completers. 

7100 

MESSAGE 

code subspace has no unwind 
subspace (7100) 


CAUSE 

Internal compiler error. 


ACTION 

Report error to your H P Service 
Representative. 

7101 

MESSAGE 

Improper completer ,completer 
given for opcode opcode 


CAUSE 

1 nternal compiler error. 


ACTION 

Report error to your H P Service 
Representative. 

7102 

MESSAGE 

Immediate value of value for 
5-bit-field in opcodenotin 
[0..31] 


CAUSE 

1 nternal compiler error. 


ACTION 

Report error to your H P Service 
Representative. 

7103 

MESSAGE 

Extract/deposit of value for field size 
in opcode not in [1..32] 


CAUSE 

Internal compiler error. 


ACTION 

Report error to your H P Service 
Representative. 

7104 

MESSAGE 

Immediate value of value for 
opcode is less than -16 (set 
to -16) 


CAUSE 

Internal compiler error. 


ACTION 

Report error to your H P Service 
Representative. 
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7105 

MESSAGE 

Immediate value of value for 
opcode is greater than 15 (set 
to 15) 


CAUSE 

1 nternal compiler error. 


ACTION 

Report error to your H P Service 
Representative. 

7106 

MESSAGE 

DSR value of %ls for %2s not 
in [0..3] - truncated (7106) 


CAUSE 

Internal compiler error. 


ACTION 

Report error to your H P Service 
Representative. 

7107 

MESSAGE 

csr value of value for opcode 
not in [0..7] - truncated 


CAUSE 

Internal compiler error. 


ACTION 

Report error to your H P Service 
Representative. 

7108 

MESSAGE 

The value hex-value did not fit into a 
signed number bit field at offset 
Oxinstructi on-offset (op code- 
op-number) 


CAUSE 

Internal compiler error. 


ACTION 

Report error to your H P Service 
Representative. 

7109 

MESSAGE 

Tried to define value of 
non-absolute symbol %ls 
(7109) 


CAUSE 

Internal compiler error. 


ACTION 

Report error to your H P Service 
Representative. 

7110 

MESSAGE 

Instruction bypassed 
low-level manip (7110) 


CAUSE 

Internal compiler error. 


ACTION 

Report error to your H P Service 
Representative. 
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7111 

MESSAGE 

Bad annotation (7111) 


CAUSE 

Internal compiler error. 


ACTION 

Report error to your H P Service 
Representative. 

7112 

MESSAGE 

Mandatory completer missing 
for opcode %ls (7112) 


CAUSE 

Internal compiler error. 


ACTION 

Report error to your H P Service 
Representative. 
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Limit Error Messages 

Thefol lowing messages describe limit errors that cause the Assembler to 
terminate immediately and prevent it from creating an object file, you 
may be able to work around these errors. They involve running into 
Assembler limits or running out of memory. 

7200 MESSAGE start/new_pool: out of 

memory. (7200) 

CAUSE The compiler attempted to allocate 

some dynamic memory, and the 
system was unable to provide the 
memory. 

ACTION The easiest workaround is to break 

your compilation unit into two or 
more pieces and compile them 
separately. 

On H P-UX, this error may also be 
produced if the system runs out of 
swap space. You can increase the 
amount of swap space avail able to the 
system (see your H P-UX system 
administrator). However, this should 
only be a last-resort. 

7201 MESSAGE new_slc_block: out of memory. 

(7201) 

CAUSE The compiler attempted to allocate 

some dynamic memory, and the 
system was unable to provide the 
memory. 

ACTION See message 7200. Check the system 

limits because other processes might 
be running that alsoallocatedynamic 
memory. 

Break up your compilation module 
into smaller pieces, and compile them 
separately. 
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7202 


7203 


7204 


MESSAGE 

CAUSE 


ACTION 


MESSAGE 

CAUSE 


ACTION 


MESSAGE 

CAUSE 


I ncrease the system swap area. 

init_link: out of memory. 
(7202) 

Compiler ran out of virtual memory. 
The compiler attempted to allocate 
some dynamic memory, and the 
system was unable to provide the 
memory. 

See message 7200. Check the system 
limits because other processes might 
be running that also allocate dynamic 
memory. 

Break up your compilation module 
into smaller pieces, and compile them 
separately. 

I ncrease the system swap area. 

allocate_bytes: out of 
memory. (7203) 

Compiler ran out of virtual memory. 
The compiler attempted to allocate 
some dynamic memory, and the 
system was unable to provide the 
memory. 

See message 7200. Check the system 
limits because other processes might 
be running that also allocate dynamic 
memory. 

Break up your compilation module 
into smaller pieces, and compile them 
separately. 

I ncrease the system swap area. 

error in writing to output 
file. (7204) 

I/O error writing to object file. 


184 


Chapter 8 




Diagnostic Messages 

Limit Error Messages 



ACTION 

Check for full filesystem 
(HPUX-MPE/iX) or too small object 
file (M PE/iX). 

7205 

MESSAGE 

unable to allocate space for 
object in RL. (7205) 


CAUSE 

I/O error writing to RL. 


ACTION 

Check for too small RL file (M PE/iX). 

7206 

MESSAGE 

unable to add object to RL. 
(7206) 


CAUSE 

I/O error writing to RL. 


ACTION 

Check for too small RL file or write 
permission (M PE/iX). 

7207 

MESSAGE 

object is too big to fit into 
RL. (7207) 


CAUSE 

Object size is too large for the RL 
requested. 


ACTION 

Check for too small RL file or split 
object up (MPE/iX). 

7208 

MESSAGE 

Internal error while reading 
%ls (7208) 


CAUSE 

An error condition was returned 
while attempting to open or read data 
from an object file. 


ACTION 

Check status of the object files used 
to build this program. You might also 
try recompiling the source file. 

7209 

MESSAGE 

Out of memory while reading 
%ls (7209) 


CAUSE 

Compiler ran out of virtual memory 
while reading 1 SOM file. 


ACTION 

See message 7200. 

7210 

MESSAGE 

Internal error while writing 
%ls (7210) 
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CAUSE 

An error condition was returned 
while attempting to open or write 
data from an object file. 


ACTION 

Check file permissions and the status 
of object files being written by the 
compiler. 

7211 

MESSAGE 

Out of memory while writing 
%ls (7211) 


CAUSE 

Compiler ran out of virtual memory 
whilewriting ISOM file. 


ACTION 

See message 7200. 

7212 

MESSAGE 

get_m_heap: out of memory. 
(7212) 


CAUSE 

Compiler ran out of virtual memory. 


ACTION 

See message 7200. 

7213 

MESSAGE 

OUTPUT_byte: out of memory. 
(7213) 


CAUSE 

Compiler ran out of virtual memory. 


ACTION 

See message 7200. 

7214 

MESSAGE 

Out of memory while writing 
ELF file. (7214) 


CAUSE 

Compiler ran out of virtual memory. 


ACTION 

See message 7200. 
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Branching Error Messages 

The foil owing messages describe branching errors that prevent the 
Assembler from creating an object file. You must correct these errors to 
assemble your program. 

7400 MESSAGE Procedure number %ls has no 

label known to linker (7400) 

CAUSE I nternal compiler error. 

ACTION Report error to your H P Service 

Representative. 

7401 MESSAGE Attempt to set location 

counter backward with .ORIGIN 
value \ of %ls (7401) 

CAUSE I nternal compiler error. 

ACTION Report error to your H P Service 

Representative. 

7402 MESSAGE Procedure call to non entry 

point: %ls (7402) 

CAUSE I nternal compiler error. 

ACTION Report error to your H P Service 

Representative. 

7403 MESSAGE undefined label - %ls (7403) 

CAUSE I nternal compiler error. 

ACTION Report error to your H P Service 

Representative. 

7404 MESSAGE branch target %ls 

unresolvable, instruction 
number %2s 
(7404) 

CAUSE I nternal compiler error. 

ACTION Report error to your H P Service 

Representative. 
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7405 


7406 


7407 


7408 


7800 


7801 


MESSAGE 

CAUSE 

ACTION 

MESSAGE 

CAUSE 

ACTION 

MESSAGE 

CAUSE 

ACTION 

MESSAGE 

CAUSE 

ACTION 

MESSAGE 

CAUSE 

ACTION 

MESSAGE 


branch target %ls 
unresolvable, instruction 
number %2s 
(7405) 

Internal compiler error. 

Report error to your H P Service 
Representative 

label known to linker deleted 
(7406) 

Internal compiler error. 

Report error to your H P Service 
Representative. 

Corrupt or unrecognized 
intermediate code in %ls 
(7407) 

The ucode in the ISOM file is not 
recognizable. 

Report error to your H P Service 
Representative. 

File I/O error while reading 
%ls (7408) 

A file operation on the ISOM file 
failed. 

Check the reasons for why the file 
was not readable by user. 

deletion of instruction has 
removed a target at %ls 
(7800) 

Internal compiler error. 

Report error to your H P Service 
Representative. 

attempt to delete 
non-existent instruction 
(7801) 
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CAUSE 

Internal compiler error. 


ACTION 

Report error to your H P Service 
Representative. 

7802 

MESSAGE 

attempt to insert 
non-existent inst. (7802) 


CAUSE 

Internal compiler error. 


ACTION 

Report error to your H P Service 
Representative. 

7203 

MESSAGE 

attempt to insert labeled 
instruction (7803) 


CAUSE 

Internal compiler error. 


ACTION 

Report error to your H P Service 
Representative. 

7804 

MESSAGE 

set_inst : attempt to set 
preg field of an instruction 
(7804) 


CAUSE 

Internal compiler error. 


ACTION 

Report error to your H P Service 
Representative. 

7805 

MESSAGE 

internal instruction parsing 
error (7805) 


CAUSE 

1 nternal compiler error. 


ACTION 

Report error to your H P Service 
Representative. 

7806 

MESSAGE 

re_init_sllic : output file 
not open (7806) 


CAUSE 

Internal compiler error. 


ACTION 

Report error to your H P Service 
Representative. 

7807 

MESSAGE 

re_init_sllic : i/o error 
(7807) 


CAUSE 

Internal compiler error. 
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ACTION 

Report error to your H P Service 
Representative. 

7808 

MESSAGE 

re_init_sllic : file position 
out of alignment (7808) 


CAUSE 

Internal compiler error. 


ACTION 

Report error to your H P Service 
Representative. 

7809 

MESSAGE 

Data size not equal to 
subspace length. (7809) 


CAUSE 

Internal compiler error. 


ACTION 

Report error to your H P Service 
Representative. 

7810 

MESSAGE 

push_mappings: Stack 
overflow. (7810) 


CAUSE 

Internal compiler error. 


ACTION 

Report error to your H P Service 
Representative. 

7811 

MESSAGE 

pop_mappings: Stack 
underflow. (7811) 


CAUSE 

Internal compiler error. 


ACTION 

Report error to your H P Service 
Representative. 

7812 

MESSAGE 

enter_VT: String too long ( > 
8K-12 bytes). (7812) 


CAUSE 

Internal compiler error. 


ACTION 

Report error to your H P Service 
Representative. 

7813 

MESSAGE 

fixup_DNTT_entry: no graph 
entry for symbol %ls. 

(7813) 


CAUSE 

Internal compiler error. 


ACTION 

Report error to your H P Service 
Representative. 
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7814 

MESSAGE 

fixup_DNTT_entry: can't find 
procedure end for symbol 
%ls. (7814) 


CAUSE 

Internal compiler error. 


ACTION 

Report error to your H P Service 
Representative. 

7815 

MESSAGE 

Malloc: underflow detected in 
free () . (7815) 


CAUSE 

Internal compiler error. 


ACTION 

Report error to your H P Service 
Representative. 

7816 

MESSAGE 

Malloc: overflow detected in 
free(). (7816) 


CAUSE 

Internal compiler error. 


ACTION 

Report error to your H P Service 
Representative. 

7817 

MESSAGE 

Malloc: Item being freed is not in use. 
(7817) 


CAUSE 

Internal compiler error. 


ACTION 

Report error to your H P Service 
Representative. 

7818 

MESSAGE 

Malloc: Item being freed is 
of wrong size. (7818) 


CAUSE 

Internal compiler error. 


ACTION 

Report error to your H P Service 
Representative. 

7819 

MESSAGE 

Disasm: Attempt to print NIL 
expression. (7819) 


CAUSE 

Internal compiler error. 


ACTION 

Report error to your H P Service 
Representative. 

7820 

MESSAGE 

Disasm: Bad format in format 
string: %s (7820) 
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CAUSE 

Internal compiler error. 


ACTION 

Report error to your H P Service 
Representative. 

7821 

MESSAGE 

after: only one graph entry 
allowed for repeated inits. 
(7821) 


CAUSE 

Internal compiler error. 


ACTION 

Report error to your H P Service 
Representative. 

7822 

MESSAGE 

newfixup: invalid fixup. 

(7822) 


CAUSE 

Internal compiler error. 


ACTION 

Report error to your H P Service 
Representative. 

7823 

MESSAGE 

xdb_sup: XT entry out of 
order. (7823) 


CAUSE 

Internal compiler error. 


ACTION 

Report error to your H P Service 
Representative. 

7824 

MESSAGE 

inst: Illegal use of pseudo 
AP register. (7824) 


CAUSE 

Internal compiler error. 


ACTION 

Report error to your H P Service 
Representative. 

7825 

MESSAGE 

inst: Illegal use of floating 
point register. (7825) 


CAUSE 

Internal compiler error (unless using 
the Assembler). 


ACTION 

Report error to your H P Service 
Representative. 

7826 

MESSAGE 

Improper format for 
sched.models. (7826) 
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7827 


7828 


7834 


7835 


CAUSE 


ACTION 


MESSAGE 

CAUSE 

ACTION 


MESSAGE 

CAUSE 

ACTION 

MESSAGE 

CAUSE 

ACTION 

MESSAGE 


Contents of the file sched. models 
were unexpected. This file should 
contain current mappings between 
machine model numbers and 
architecture revisions. 

Check that 

/opt/langtools/lib/sched.modeIs 
or /usr/lib/sched.models were 
installed or updated along with your 
current version of the operating 
system. 

Invalid architecture version. 
(7827) 

The architecture revision provided in 
the file sched. models is not known 
to the compiler. 

Check the format of any +da option 
specified to the compiler. If none 
specified or format is correct, check 
that the file sched.models (in either 
/opt/langtools/lib Or /usr/lib) 
was installed or updated along with 
your current version of the operating 
system. 

inst: Illegal displacement, 
low order bits must be zero. 

Internal compiler error (unless using 
the Assembler). 

Report error to your nearest H P 
Service Representative. 

Procedure limit reached. 
(7834) 

Too many procedures. 

Reduce the number of procedures. 

Internal error encountered 
while generating ELF file. 
(7835) 
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7836 


7837 


CAUSE 

ACTION 

MESSAGE 

CAUSE 

ACTION 

MESSAGE 

CAUSE 

ACTION 


Internal compiler error. 

Report error to your H P Service 
Representative 

Files with executable code 
must have at least one 
exported code 

symbol. (7836) 

Your assembly file contains 
executable code but does not have 
any exported entry points. 

Use the .export directive for one of 
your entry points or code symbols. 

.WORD pseudo-op cannot hold a 
64-bit address. Use .DWORD 
instead. (7837) 

Your PA2.0W assembly file contains a 
.word expr pseudo-operation, where 
expr is an address expression. 

Change the pseudo-op to . dword 
expr 
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Symbols 

# 

label field, 19 
$BSS$ 

64-bit mode, 44 
$BSS$ subspace, 43, 74 
$CODE$ 

64-bit mode, 44 
$CODE$ subspace, 43, 61, 91 
$DATA$ subspace, 43, 61, 91 
$DEBUG$ space, 41 
$DLT$ subspace, 43 
$GLOBAL$ subspace, 43, 49 
$LIT$ subspace, 43 
$MILLICODE$subspace, 43 
$PLT$ subspace, 43 
$PRI VAT E$ space, 40, 41, 43, 
49, 74 

$SHLI B_DATA$ subspace, 43 
$SHLI B_INFO$ subspace, 43 
$SHORTBSS$ subspace, 43, 50 
$SHORTDATA$ subspace, 43, 
50 

$TBSS$ subspace, 50 
$TEXT$ space, 40, 41, 43 
$U NWI ND$ subspace, 43 
(MRP) MillicodeReturn Pointer, 
70 

.(period) 

special symbol, 21 
.ALIGN directive, 42, 57 
.ALLOW directive, 58, 93 
.BLOCK pseudo-operation, 60, 
101 

.BLOCKZ pseudo-operation, 60 
.bss 

64-bit mode, 44 
.BSS predefined subspace 
directive, 116 

.BYTE pseudo-operation, 62 
.CALL directive, 63, 86 
.CALLI NFO directive, 48, 67, 
81, 102 


.CODE directive, 43, 52 
.CODE predefined subspace 
directive, 116 
.COMM directive, 74 
.COPYRIGHT directive, 75 
.DATA directive, 43, 52 
.DATA predefined subspace 
directive, 116 

.DOUBLE pseudo-operation, 77 
.DWORD pseudo-operation, 78 
.END directive, 79 
.ENDM directive, 80, 98 
.ENTER pseudo-operation, 28, 
48, 52, 67, 81, 83, 95, 102 
.ENTRY directive, 83 
.EQU directive, 19, 21, 25, 84 
.EXIT directive, 83, 102 
.EXPORT directive, 48, 85 
.FIRST predefined subspace 
directive, 116 

.FLOAT pseudo-operation, 88 
.GATE predefined subspace 
directive, 116 

.GLOBAL predefined subspace 
directive, 116 

.GNTT predefined subspace 
directive, 116 

.HALF pseudo-operation, 89 
.HEADER predefined subspace 
directive, 116 

.HEAP predefined subspace 
directive, 116 
.IMPORT directive, 49, 90 
.LABEL directive, 20, 92 
.LEAVE pseudo-operation, 28, 
48, 52, 67, 81, 83, 95, 102 
.LEVEL directive, 58, 93 
.LISTOFF directive, 52, 95 
.LISTON directive, 52, 95 
.LIT predefined subspace 
directive, 116 

.LNTT predefined subspace 
directive, 117 


.LOCCT directive, 46, 97 
.MACRO directive, 19, 21, 37, 
80, 98 

.MILLICODE predefined 
subspace directive, 117 
.ORIGIN directive, 101 
.PCB predefined subspace 
directive, 117 
.PROC directive, 48, 102 
.PROCEND directive, 48, 102 
.REAL predefined subspace 
directive, 117 

.RECOVER predefined subspace 
directive, 117 

.REG directive, 19, 21, 25, 35, 

104 

.RESERVED predefined 
subspace directive, 117 
.SH LI B_VE RSI ON directive, 

105 

.SHORTDATA predefined 
subspace directive, 117 
.SLT predefined subspace 
directive, 117 

.SPACE directive, 41, 43, 106 
.SPNUM pseudo-operation, 108 
.STACK predefined subspace 
directive, 117 

.STRING pseudo-operation, 109 
.STRINGZ pseudo-operation, 

109 

.SUBSPA directive, 43, 46, 107, 
111 
.text 

64-bit mode, 44 

.U N Wl N D predefined subspace 
directive, 117 
.VERSION directive, 114 
.VT predefined subspace 
directive, 117 

.WORD pseudo-operation, 115 
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Index 


Numerics 

64-bit environment, 16, 17, 23, 
24, 33, 39, 44 
SeeAlso PA-RISC 2.0W 
.ALLOW directive, 58 
.CALL directive, 63 
.CALLINFO directive, 71 
.EXPORT Directive, 85 
.EXPORT directive, 85, 86 
.LEVEL directive, 93 
.SUBSPA directive. 111 
Executableand Linking 
Format, 16, 17, 111 
memory, 44 

A 

ABSOLUTE 
symbols, 85 
absolute 
expressions, 16 
result, 29 
symbols, 15 
absolute symbols 
parenthesized subexpressions, 
34 

access rights attribute and 
subspaces, 42 

add and branch conditions, 122 
ADDB pseudo-instruction, 120 
ADDIB pseudo-instruction, 120 
address expressions, 16 
addressing 
long, 40 
short, 40 

advancing location counter, 101 
next alignment boundary, 57 
alignment attributeand 
subspaces, 42 

allowing a label definition, 92 
argO 

registers, 136 
arithmetic 


expressions, 29 
operators, 29 
as 

using instead of cc command, 
136 

as command, 124 
options, 124 
ASCI I value 

initializing reserved storageto, 
109 

Assembler, 15 
expressions, 16 
features, 15 
invoking, 123 
list of directives, 53 
list of pseudo-operations, 55 
location counters, 16 
machine language, 15 
macro processing, 16 
mnemonic instructions, 15 
pseudo-operations, 53 
relocatable object file, 15 
source file, 15 
storage allocation, 16 
subspaces, 16 
symbol scope, 16 
symbolic addresses, 15 
symbolic constants, 15 
assembling your program, 123, 
136 

assembly language 
listing, 51 
procedures, 39 
programming example 
binary search for highest bit 
position, 130 

C program calling assembly, 
136 

C program generating assem¬ 
bly code, 138 
copying a string, 132 
dividing a double-word divi¬ 
dend, 134 


programming examples, 129 
programming for HP-UX, 39 
programs, 15, 39 
assembly statement 
comments, 19, 20 
directives, 19 
instructions, 19 
label, 19 
opcode, 19 
operands, 19, 20 
pseudo-operations, 19 
assigning an expression valueto 
an identifier, 84 


B pseudo-instruction, 120 
bit-wise operators, 29 
blocks of storage, reserving, 60 
branch statement 
marking, 63 
procedure call, 63 
branching messages, 187 


C compiler 
dependencies, 136 
passing arguments to 
Assembler, 127 
passing arguments toC 
preprocessor, 127 
passing arguments to linker, 
127 

C language 

preprocessor (cpp), 128 
type string, 109 
calling conventions, 47 
catalog 
message, 141 
cc command 
dependencies, 136 
using, 127 
CODE 
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Index 


symbols, 85 

COMB pseudo-instruction, 120 
COM IB pseudo-instruction, 120 
command 
as, 124 
cc, 127 

comments field, 19, 20 
compare and branch conditions, 
121 

compiler conventions, 47 
completers, 35 
macros, 37 
condition 

add and branch, 122 
compare and branch, 121 
constants, 21 
integer, 21 

parenthesized subexpressions, 
34 

register-type, 25 
control registers, 24 
COPY pseudo-instruction, 120 
counter, location, 97, 101 
cpp (C preprocessor), 128 
creating 

entry/exit code sequences, 67 
stack unwind descriptors, 67 
current procedure 
describing environment of, 67 

D 

DATA 
symbols, 85 
declaring 
a new space, 106 
a new subspace. 111 
beginning of macro definition, 
98 

begi nni ng of procedure, 102 
end of a procedure, 102 
predefined subspace, 95 
defining 


new instructions, with macros, 
37 

delay slot, 119 
instructions, 119 
demonstrating the procedure 
calling convention, 136 
dependencies, 136 
cc command, 136 
pcc_prefix.s, 136 
describing environment of 
current procedure, 67 
diagnostic messages, 141 
directives, 53 
.ALIGN, 42, 57 
.ALLOW, 58, 93 
.CALL, 63, 86 

.CALLINFO, 48, 67, 81, 102 
.CODE, 43, 52 
.COMM, 74 
.COPYRIGHT, 75 
.DATA, 43, 52 
.END, 79 
.ENDM, 80, 98 
.ENTRY, 83 
.EQU, 19, 21, 25, 84 
.EXIT, 83, 102 
.EXPORT, 48, 85 
.IMPORT, 49, 90 
.LABEL, 20, 92 
.LEVEL, 58, 93 
.LISTOFF, 52, 95 
.LISTON, 52, 95 
.LOCCT, 46, 97 
.MACRO, 19, 21, 37, 80, 98 
.ORIGIN, 101 
.PROC, 48, 102 
.PROCEND, 48, 102 
.REG, 19, 21, 25, 35, 104 
,SHLIB_VERSION, 105 
.SPACE, 41, 43, 106 
.SUBSPA, 43, 46, 107, 111 
.VERSION, 114 
list of, 53 


predefined subspace, 116 
dp register, 49 
DS 

divide step example, 134 


ending the program, 79 
ENTRY 
symbols, 85 
entry points 

marking procedure, 81, 83 
error messages, 141, 154 
errors 

out of memory, 183 
examples, 129 
binary search for highest bit 
position, 130 

C program calling assembly, 
136 

C program generating 
assembly code, 138 
copying a string, 132 
dividing a double-word 
dividend, 134 

Executable and Linking Format 
64-bit environment, 16, 17, 
111 

executable program file, 15 
exit points 

marking procedure, 81, 83 
expansion of macros, 95 
expressions, 16 
absolute, 16 
absolute result, 29 
address, 16 
assigning value to an 
identifier, 84 
integer constants, 29 
relocatable, 16 
relocatable result, 29 
symbolic addresses, 29 
symbolic constants, 29 
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F 

feature 

implementation-specific, 58, 

93 

field selectors, 30, 51 
shared libraries, 33 
fields 

comments, 19, 20 
label, 19 
opcode, 19 
operands, 19, 20 
fixed argument list, 68 
floating-point 
registers, 23 
floating-point value 
initializing a double-word to, 
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